XCode 10.2 日本語化計画：Swift 標準ライブラリ String

文書   >   Swift   >  String   >   index(_:offsetBy:)

インスタンスメソッド

index(_:offsetBy:)

与えられたインデックスから指定された距離にあるインデックスを返します。

宣言

パラメータ

戻り値

インデックス i から n だけオフセットしたインデックス。n が正の場合、これは index(after:) に対する n 回の呼び出しの結果と同じ値です。n が負の場合、これは -n 回の index(before:) の呼び出しの結果と同じ値です。

議論

以下の例では、文字列の開始インデックスから 4 つ進んだ位置にあるインデックスを取得してから、その位置に文字を印刷します。

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

n として渡される値は、コレクションの境界を超えて i をオフセットしてはいけません。

複雑さ：O(n)、ここで n は n の絶対値です。

関連

プロトコルから

BidirectionalCollection




Collection

以下も見よ

インデックスの操作

var startIndex: String.Index




空でない文字列内の最初の文字の位置。




var endIndex: String.Index




文字列の "最後を過ぎた" 位置、つまり最後の有効なサブスクリプト引数より 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 formIndex(inout String.Index, offsetBy: Int)




与えられたインデックスを指定された距離だけオフセットします。




func formIndex(inout String.Index, offsetBy: Int, limitedBy: String.Index) -> Bool




与えられたインデックスを指定された距離だけオフセットするか、または与えられた制限インデックスと等しくなるようにします。




func distance(from: String.Index, to: String.Index) -> String.IndexDistance




2 つのインデックス間の距離を返します。




var indices: DefaultIndices<String>




コレクションをサブスクリプトするのに有効なインデックス（昇順で）。