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