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
宣言
funcindex(_i: Index, offsetBydistance: Int) -> Index
Parameters
パラメータ
i
A valid index of the collection.
そのコレクションの有効なインデックス。
distance
The distance to offset i. distance must not be negative unless the collection conforms to the BidirectionalCollection protocol.iを補う間隔。distanceは、そのコレクションがBidirectionalCollectionプロトコルに準拠するのでない限り、負であってはなりません。
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.
以下の例は、文字列の開始インデックスから4位置進んだインデックスを取得して、それからその位置の文字を出力します。
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 RandomAccessCollection; otherwise, O(k), where k is the absolute value of distance.
計算量:もしコレクションがRandomAccessCollectionに準拠するならば、O(1);そうでなければ、O(k)、そこでkはdistanceの値の絶対値です。
The “past the end” position for the set—that is, the position one greater than the last valid subscript argument.
集合に対する「終わりを過ぎた」位置—すなわち、最後の有効な添え字引数より1つ大きい位置。
Returns an index that is the specified distance from the given index, unless that distance is beyond a given limiting index.
与えられたインデックスから指定された隔たりのインデックスを返します、その隔たりが与えられた限界インデックスを越えない限りは。
Offsets the given index by the specified distance, or so that it equals the given limiting index.
与えられたインデックスをこの指定された隔たりで補います、またはそれでそれは与えられた限界インデックスと等しくなります。