文書   >   Swift   >  String   >   formIndex(_:offsetBy:limitedBy:)
インスタンスメソッド
formIndex(_:offsetBy:limitedBy:)
与えられたインデックスを指定された距離だけオフセットするか、または与えられた制限インデックスと等しくなるようにします。
宣言
パラメータ
i | コレクションの有効なインデックス。 |
distance | オフセット i までの距離。コレクションが BidirectionalCollection プロトコルに準拠していない限り、distance は負にしてはいけません。 |
limit | 制限 (limit) として使用すべきコレクションの有効なインデックス。distance > 0 の場合、i より小さい制限は効果がありません。同様に、distance < 0 の場合、i より大きい制限は効果がありません。 |
戻り値
limit を超えずに正確に distance ステップで i がオフセットされている場合は true。そうでなければ、false。戻り値が false の場合、i の値は limit に等しくなります。
議論
distance として渡される値は、コレクションの境界を超えて i をオフセットしてはいけません。ただし limit として渡されるインデックスが境界を越えてオフセットするのを妨げない限り。
複雑さ:コレクションが RandomAccessCollection に準拠している場合 O(1)、それ以外の場合 O(k)、ここで k は distance の絶対値です。
以下も見よ
インデックスの操作
空でない文字列内の最初の文字の位置。
文字列の "最後を過ぎた" 位置、つまり最後の有効なサブスクリプト引数より 1 つ大きい位置。
func index(after: String.Index) -> String.Index
与えられたインデックスの直後の位置を返します。
func formIndex(after: inout String.Index)
与えられたインデックスをその後継者で置き換えます。
func index(before: String.Index) -> String.Index
与えられたインデックスの直前の位置を返します。
func formIndex(before: inout String.Index)
与えられたインデックスをその前にあった物で置き換えます。
func index(String.Index, offsetBy: String.IndexDistance, limitedBy: String.Index) -> String.Index?
与えられたインデックスから指定された距離にあるインデックスを返します。ただし、その距離が与えられた制限インデックスを超えない限り。
func index(String.Index, offsetBy: String.IndexDistance, limitedBy: String.Index) -> String.Index?
与えられたインデックスから指定された距離にあるインデックスを返します。ただし、その距離が与えられた制限インデックスを超えない限り。
func formIndex(inout String.Index, offsetBy: Int)
与えられたインデックスを指定された距離だけオフセットします。
func distance(from: String.Index, to: String.Index) -> String.IndexDistance
2 つのインデックス間の距離を返します。
var indices: DefaultIndices<String>
コレクションをサブスクリプトするのに有効なインデックス(昇順で)。
トップへ(Swift 標準ライブラリ)
トップへ(Swift 標準ライブラリ)
トップへ(Swift 標準ライブラリ)
トップへ(Swift 標準ライブラリ)