A valid index of the collection. そのコレクションの有効なインデックス。
index(_:offsetBy:limitedBy:)
Availability
- iOS 8.0+
- iPadOS 8.0+
- macOS 10.15+
- Mac Catalyst 13.0+
- tvOS 9.0+
- watchOS 2.0+
- Xcode 10.2+
Technology
- Swift Standard Library Swift標準ライブラリ
Declaration 宣言
func index(_ i: LazyMapSequence
<Base, Element>.Index
, offsetBy n: Int
, limitedBy limit: LazyMapSequence
<Base, Element>.Index
) -> LazyMapSequence
<Base, Element>.Index
?
Base
conforms to Collection
.
Base
がCollection
に準拠する時に利用可能です。
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 戻り値
An index offset by distance
from the index i
, unless that index would be beyond limit
in the direction of movement. In that case, the method returns nil
.
distance
だけインデックスi
から補われたインデックス、そのインデックスが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
value, so it succeeds.
以下の例は、文字列の開始インデックスから4位置進んだインデックスを取得して、それからその位置の文字を出力します。演算は、限界であるs
値を越えていく必要はありません、それでそれは成功します。
The next example attempts to retrieve an index six positions from s
but fails, because that distance is beyond the index passed as limit
.
次の例はs
から6位置のインデックスをとりだすことを試みます、しかし失敗します、なぜならその間隔はlimit
として渡されるインデックスを越えるからです。
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
の値の絶対値です。
Note 注意
This documentation comment was inherited from Collection
.
この文書化コメントは、Collection
から引き継がれました。