文書 > Swift > Array > formIndex(_:offsetBy:limitedBy:)
インスタンスメソッド
formIndex(_:offsetBy:limitedBy:)
与えられたインデックスを指定された距離だけオフセットするか、または与えられた制限のインデックスと等しくなるようにします。
宣言
パラメータ
| i | コレクションの有効なインデックス。 |
| distance | i をオフセットすべき距離。コレクションが BidirectionalCollection プロトコルに準拠していない限り、distance は負にしてはいけません。 |
| limit | 制限 (limit) として使用すべきコレクションの有効なインデックス。distance > 0 の場合、limit が i より小さい場合、効果がありません。同様に、distance < 0 の場合、limit が i より大きい場合、効果がありません。 |
戻り値
limit を超えずに正確に distance のステップで i がオフセットされている場合は true。そうでなければ、false。戻り値が false の場合、i の値は limit に等しくなります。
議論
limit として渡されたインデックスがこれらの境界を超えたオフセットを妨げない限り、distance として渡された値はコレクションの境界を超えて i をオフセットしてはいけません。
複雑さ：コレクションが RandomAccessCollection に準拠している場合 O(1)、それ以外の場合、O(k)、ここで k は distance の絶対値です。
以下も見よ
インデックスの操作
空でない配列内の最初の要素の位置。
配列の "最後を過ぎた" 位置、つまり最後の有効なサブスクリプト引数より 1 つ大きい位置。
与えられたインデックスの直後の位置を返します。
func formIndex(after: inout Int)
与えられたインデックスをその後継者に置き換えます。
func index(before: Int) -> Int
与えられたインデックスの直前の位置を返します。
func formIndex(before: inout Int)
与えられたインデックスをその前にあったインデックスに置き換えます。
func index(Int, offsetBy: Int) -> Int
与えられたインデックスから指定された距離にあるインデックスを返します。
func formIndex(inout Int, offsetBy: Int)
与えられたインデックスを指定された距離だけオフセットします。
func index(Int, offsetBy: Int, limitedBy: Int) -> Int?
与えられたインデックスから指定された距離にあるインデックスを返します。ただし、その距離が与えられた制限のインデックスを超えている場合は除きます。
func distance(from: Int, to: Int) -> Int
2 つのインデックス間の距離を返します。
昇順で、コレクションをサブスクリプトするのに有効なインデックス。
トップへ
トップへ
トップへ
トップへ
トップへ