XCode 9.3 日本語化計画：Swift 標準ライブラリ subscript(_:)

文書   >   Swift 標準ライブラリ   >   Collections   >   Supporting Types   >   AnyRandomAccessCollection   >   subscript(_:)

汎用サブスクリプト

subscript(_:)

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

宣言

subscript<R>(r: R) -> AnyRandomAccessCollection<Element> where R :
 RangeExpression, AnyRandomAccessCollection.Index == R.Bound { get }

パラメータ

議論

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

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

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

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

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

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

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

複雑さ：O(1)

関連

汎用の制約

R : RangeExpression




Self.Index == R.Bound