index(_:offsetBy:limitedBy:)

Return Value 戻り値

An index offset by n from the index i, unless that index would be beyond limit in the direction of movement. In that case, the method returns nil. インデックスiからnだけ補われたインデックス、そのインデックスがlimitを移動方向において越えない限りは。その場合には、このメソッドはnilを返します。

Discussion 解説

The following example obtains an index advanced four positions from a string’s starting index and then prints the character at that position. The operation doesn’t require going beyond the limiting s.endIndex value, so it succeeds. 以下の例は、文字列の開始インデックスから４位置進んだインデックスを取得して、それからその位置の文字を出力します。演算は、限界であるs.endIndex値を越えていく必要はありません、それでそれは成功します。

let s = "Swift"
if let i = s.index(s.startIndex, offsetBy: 4, limitedBy: s.endIndex) {
    print(s[i])
}
// Prints "t"

The next example attempts to retrieve an index six positions from s.startIndex but fails, because that distance is beyond the index passed as limit. 次の例はs.startIndexから６位置のインデックスをとりだすことを試みます、しかし失敗します、なぜならその間隔はlimitとして渡されるインデックスを越えるからです。

let j = s.index(s.startIndex, offsetBy: 6, limitedBy: s.endIndex)
print(j)
// Prints "nil"

The value passed as n must not offset i beyond the bounds of the collection, unless the index passed as limit prevents offsetting beyond those bounds. nとして渡される値は、このコレクションの境界を越えてiを補ってはなりません、limitとして渡されるインデックスがそれら境界を越えて補うのを防止するのでない限りは。

Complexity: O(n), where n is the absolute value of n. 計算量：O(n)、そこでnはnの値の絶対値です。