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

文書   >   Swift   >  String   >   subscript(_:)

汎用サブスクリプト

subscript(_:)

範囲式で指定されたコレクションの要素の連続した部分範囲にアクセスします。

宣言

パラメータ

議論

範囲式は、このコレクションを基準にした具象的な部分範囲に変換されます。たとえば、PartialRangeFrom 範囲式を配列とともに使用すると、範囲式の先頭から配列の末尾までの部分範囲にアクセスします。

let streets = ["Adams", "Bryant", "Channing", "Douglas", "Evarts"]
let streetsSlice = streets[2...]
print(streetsSlice)
// ["Channing", "Douglas", "Evarts"]

アクセスされたスライスは、元のコレクションが使用しているのと同じ要素に対して同じインデックスを使用します。この例では、streetsSlice でスライス内の文字列の 1 つを検索してから、そのインデックスを元の配列で使用します。

let index = streetsSlice.firstIndex(of: "Evarts")    // 4
print(streets[index!])
// "Evarts"

スライスの startIndex プロパティがそのインデックズの特定の値で始まると仮定するのではなく、常にスライスの startIndex プロパティを使用してください。スライスのインデックスの範囲外のインデックスを使用して要素にアクセスしようとすると、そのインデックスが元のコレクションに対して有効であっても実行時エラーが発生する可能性があります。

print(streetsSlice.startIndex)
// 2
print(streetsSlice[2])
// "Channing"

print(streetsSlice[0])
// error: Index out of bounds

複雑さ：O(1)

以下も見よ

部分文字列の取得

subscript(Range<String.Index>) -> Substring




subscript((UnboundedRange_) -> ()) -> Substring




func prefix(Int) -> Substring




指定された最大長までの、コレクションの最初の要素を含む部分シーケンスを返します。




func prefix(through: String.Index) -> Substring




コレクションの先頭から指定された位置までの部分シーケンスを返します。




func prefix(upTo: String.Index) -> Substring




コレクションの先頭から指定された位置までの、それを含まない部分シーケンスを返します。




func prefix(while: (Character) -> Bool) -> Substring




predicate が false を返し、残りの要素を飛ばすまで、最初の要素を含む部分シーケンスを返します。




func suffix(Int) -> Substring




コレクションの最後の要素を含む、与えられた最大長までの部分シーケンスを返します。




func suffix(from: String.Index) -> Substring




指定された位置からコレクションの末尾までの部分シーケンスを返します。