A valid index of the collection. そのコレクションの有効なインデックス。
Instance Method
インスタンスメソッド
index(_:
index(_:offsetBy:)
Returns an index that is the specified distance from the given index.
与えられたインデックスから指定された隔たりのインデックスを返します。
Availability
- iOS 8.0+
- iPadOS 8.0+
- macOS 10.10+
- Mac Catalyst 13.0+
- tvOS 9.0+
- watchOS 2.0+
- Xcode 9.3+
Technology
- Swift Standard Library Swift標準ライブラリ
Declaration 宣言
Parameters パラメータ
idistanceThe distance to offset
i.distancemust not be negative unless the collection conforms to theBidirectionalprotocol.Collection iを補う間隔。distanceは、そのコレクションがBidirectionalプロトコルに準拠するのでない限り、負であってはなりません。Collection
Return Value 戻り値
An index offset by distance from the index i. If distance is positive, this is the same value as the result of distance calls to index(after:). If distance is negative, this is the same value as the result of abs(distance) calls to index(before:).
distanceだけインデックスiから補われるインデックス。distanceが正ならば、これはdistanceでindex(after:)を呼び出す結果と同じ値です。distanceが負ならば、これはabs(distance)でindex(before:)を呼び出す結果と同じ値です。
Discussion 解説
The following example obtains an index advanced four positions from a string’s starting index and then prints the character at that position. 以下の例は、文字列の開始インデックスから４位置進んだインデックスを取得して、それからその位置の文字を出力します。
let s = "Swift"
let i = s.index(s.startIndex, offsetBy: 4)
print(s[i])
// Prints "t"The value passed as distance must not offset i beyond the bounds of the collection.
distanceとして渡される値は、このコレクションの境界を越えてiを補ってはなりません。
Complexity: O(1) if the collection conforms to Random; otherwise, O(k), where k is the absolute value of distance.
計算量：もしコレクションがRandomに準拠するならば、O(1)；そうでなければ、O(k)、そこでkはdistanceの値の絶対値です。