A valid index of the collection. そのコレクションの有効なインデックス。
formIndex(_:offsetBy:limitedBy:)
Availability
- iOS 8.0+
- iPadOS 8.0+
- macOS 10.15+
- Mac Catalyst 13.0+
- tvOS 9.0+
- watchOS 2.0+
- Xcode 11.0+
Technology
- Swift Standard Library Swift標準ライブラリ
Declaration 宣言
Parameters パラメータ
i
distance
The distance to offset
i
.distance
must not be negative unless the collection conforms to theBidirectional
protocol.Collection i
を補う間隔。distance
は、そのコレクションがBidirectional
プロトコルに準拠するのでない限り、負であってはなりません。Collection limit
A valid index of the collection to use as a limit. If
distance > 0
, a limit that is less thani
has no effect. Likewise, ifdistance < 0
, a limit that is greater thani
has no effect. 限度として使うためのそのコレクションの有効なインデックス。distance > 0
ならば、i
より少ない限度は効果を持ちません。同様に、distance < 0
ならば、i
より大きい限度は効果を持ちません。
Return Value 戻り値
true
if i
has been offset by exactly distance
steps without going beyond limit
; otherwise, false
. When the return value is false
, the value of i
is equal to limit
.
true
、もしi
が正確にdistance
幅だけlimit
を越えていくことなく補われたならば;そうでなければ、false
です。戻り値がfalse
の場合、i
の値はlimit
に等しいです。
Discussion 解説
The value passed as distance
must not offset i
beyond the bounds of the collection, unless the index passed as limit
prevents offsetting beyond those bounds.
distance
として渡される値は、このコレクションの境界を越えてi
を補ってはなりません、limit
として渡されるインデックスがそれら境界を越えて補うのを防止するのでない限りは。
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
の値の絶対値です。