文書   >   Swift   >   Array   >   index(_:offsetBy:)
インスタンスメソッド
index(_:offsetBy:)
与えられたインデックスから指定された距離にあるインデックスを返します。
宣言
パラメータ
i | 配列の有効なインデックス。 |
distance | i をオフセットすべき距離。 |
戻り値
インデックス i からの distance だけオフセットされたインデックス。distance が正の場合、これは index(after:) への abs(distance) 呼び出しの結果と同じ値です。distance が負の場合、これは index(after:) に対する abs(distance) 呼び出しの結果と同じ値です。
議論
以下の例では、配列の開始インデックスから 4 つ進んだインデックスを取得してから、その位置に要素を出力します。
let numbers = [10, 20, 30, 40, 50]
let i = numbers.index(numbers.startIndex, offsetBy: 4)
print(numbers[i])
// Prints "50"
distance として渡される値は、コレクションの境界を超えて i をオフセットしてはいけません。
関連
プロトコルから
RandomAccessCollection
以下も見よ
インデックスの操作
空でない配列内の最初の要素の位置。
配列の "最後を過ぎた" 位置、つまり最後の有効なサブスクリプト引数より 1 つ大きい位置。
func index(after: Int) -> Int
与えられたインデックスの直後の位置を返します。
func formIndex(after: inout Int)
与えられたインデックスをその後継者に置き換えます。
func index(before: Int) -> Int
与えられたインデックスの直前の位置を返します。
func formIndex(before: inout Int)
与えられたインデックスをその前にあったインデックスに置き換えます。
func formIndex(inout Int, offsetBy: Int)
与えられたインデックスを指定された距離だけオフセットします。
func index(Int, offsetBy: Int, limitedBy: Int) -> Int?
与えられたインデックスから指定された距離にあるインデックスを返します。ただし、その距離が与えられた制限のインデックスを超えている場合は除きます。
func formIndex(inout Int, offsetBy: Int, limitedBy: Int) -> Bool
与えられたインデックスを指定された距離だけオフセットするか、または与えられた制限のインデックスと等しくなるようにします。
func distance(from: Int, to: Int) -> Int
2 つのインデックス間の距離を返します。
昇順で、コレクションをサブスクリプトするのに有効なインデックス。
トップへ
トップへ
トップへ
トップへ
トップへ