文書 > Swift > Swift 標準ライブラリ > Collections > Sequence and Collection Protocols > Collection > index(_:offsetBy:)
インスタンスメソッド
index(_:offsetBy:)
与えられたインデックスから指定された距離のインデックスを返します。
必須。 デフォルトの実装が提供されます。
宣言
func index(_ i: Self.Index, offsetBy distance: Int) -> Self.Index
パラメータ
| i | コレクションの有効なインデックス。 |
| distance | offset 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 の絶対値です。
デフォルトの実装
コレクションの実装
func index<T>(Self.Index, offsetBy: T) -> Self.Index
与えられたインデックスから指定された距離のインデックスを返します。
廃止
func index(Self.Index, offsetBy: Int) -> Self.Index
与えられたインデックスから指定された距離のインデックスを返します。