インスタンスメソッド

formIndex(_:offsetBy:limitedBy:)

与えられたインデックスを指定された距離だけオフセットするか、与えられた制限インデックスと等しくなるようにオフセットします。

System Swift iOS 14.0+ iPadOS 14.0+ Mac Catalyst 14.0+

macOS 11.0+ tvOS 14.0+ visionOS 1.0+ watchOS 7.0+

func formIndex(

_ i: inout Self.Index,

offsetBy distance: Int

limitedBy limit: Self.Index

) -> Bool

---

パラメータ

i

コレクションの有効なインデックス。

distance

コレクションが BidirectionalCollection プロトコルに準拠していない限り、オフセット i.distance への距離は負であってはなりません。

limit

制限として使用すべきコレクションの有効なインデックス。distance > 0 の場合、i より小さい制限は無効です。同様に、distance < 0 の場合、i より大きい制限は無効です。

戻り値

i が limit を超えずに正確に distance ステップだけオフセットされた場合は true、それ以外の場合は false。戻り値が false の場合、i の値は limit と等しくなります。

議論

distance として渡される値は、limit として渡されるインデックスによってそれらの境界を超えるオフセットが禁止されていない限り、コレクションの境界を超えて i をオフセットしてはなりません。

複雑さ：

コレクションが RandomAccessCollection に準拠している場合は O(1)、それ以外の場合は O(k) (ここで k は distance の絶対値)。

トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ