Instance Method インスタンスメソッド

index(_:offsetBy:)

Returns an index that is the specified distance from the given index. 与えられたインデックスから指定された隔たりのインデックスを返します。

Declaration 宣言

func index(_ i: Self.Index, offsetBy distance: Int) -> Self.Index

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が正ならば、これはdistanceindex(after:)を呼び出すの結果と同じ値です。distanceが負ならば、これはabs(distance)index(before:)を呼び出すの結果と同じ値です。

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プロトコルに準拠する場合を除いては。

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を補ってはなりません。