Swift Collection subscript(_:)用法及代码示例

用法一

实例下标

subscript(_:)

访问集合元素的连续子范围。

必需的。提供的默认实现。

声明

subscript(bounds: Range<Self.Index>) -> Self.SubSequence { get }

参数

bounds: 一系列集合的索引。范围的边界必须是集合的有效索引。

概述

例如，将 PartialRangeFrom 范围表达式与数组一起使用会访问从范围表达式开头到数组结尾的子范围。


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

访问的切片对与原始集合相同的元素使用相同的索引。此示例在 streetsSlice 中搜索切片中的字符串之一，然后在原始数组中使用该索引。


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

始终使用切片的 startIndex 属性，而不是假设其索引从特定值开始。尝试使用切片边界之外的索引访问元素可能会导致运行时错误，即使该索引对原始集合有效。


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


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

可用版本

iOS 8.0+, iPadOS 8.0+, macOS 10.10+, Mac Catalyst 13.0+, tvOS 9.0+, watchOS 2.0+

用法二

实例下标

subscript(_:)

访问由范围表达式指定的集合元素的连续子范围。

声明

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

参数

bounds: 一系列集合的索引。范围的边界必须是集合的有效索引。

概述

范围表达式转换为相对于该集合的具体子范围。例如，将 PartialRangeFrom 范围表达式与数组一起使用会访问从范围表达式开头到数组结尾的子范围。


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

访问的切片对与原始集合使用的相同元素使用相同的索引。此示例在 streetsSlice 中搜索切片中的字符串之一，然后在原始数组中使用该索引。


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

始终使用切片的 startIndex 属性，而不是假设其索引从特定值开始。尝试使用切片索引范围之外的索引访问元素可能会导致运行时错误，即使该索引对原始集合有效。


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


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

可用版本

iOS 8.0+, iPadOS 8.0+, macOS 10.10+, Mac Catalyst 13.0+, tvOS 9.0+, watchOS 2.0+

用法三

实例下标

subscript(_:)

访问集合元素的连续子范围。

声明

subscript(bounds: Range<Self.Index>) -> Slice<Self> { get }

当 SubSequence 为 Slice<Self> 时可用。

参数

bounds: 一系列集合的索引。范围的边界必须是集合的有效索引。

概述

访问的切片对与原始集合相同的元素使用相同的索引。始终使用切片的 startIndex 属性，而不是假设其索引从特定值开始。

此示例演示获取字符串数组的切片，查找切片中字符串之一的索引，然后在原始数组中使用该索引。


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


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

可用版本

iOS 8.0+, iPadOS 8.0+, macOS 10.10+, Mac Catalyst 13.0+, tvOS 9.0+, watchOS 2.0+

用法四

实例下标

subscript(_:)

访问指定位置的元素。

必需的。提供的默认实现。

声明

subscript(position: Self.Index) -> Self.Element { get }

参数

position: 要访问的元素的位置。 position 必须是不等于 endIndex 属性的集合的有效索引。

概述

以下示例通过其下标访问数组元素以打印其值：


var streets = ["Adams", "Bryant", "Channing", "Douglas", "Evarts"]
print(streets[1])
// Prints "Bryant"

您可以使用集合的结束索引以外的任何有效索引为集合下标。结束索引是指在集合的最后一个元素之后的位置，因此它与元素不对应。

可用版本

iOS 8.0+, iPadOS 8.0+, macOS 10.10+, Mac Catalyst 13.0+, tvOS 9.0+, watchOS 2.0+

用法五

实例下标

subscript(_:)

访问集合元素的连续子范围。

声明

subscript(bounds: Range<Self.Index>) -> Slice<Self> { get set }

参数

bounds: 一系列集合的索引。范围的边界必须是集合的有效索引。

概述

访问的切片对与原始集合相同的元素使用相同的索引。始终使用切片的 startIndex 属性，而不是假设其索引从特定值开始。

此示例演示获取字符串数组的切片，查找切片中字符串之一的索引，然后在原始数组中使用该索引。


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


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

可用版本

iOS 8.0+, iPadOS 8.0+, macOS 10.10+, Mac Catalyst 13.0+, tvOS 9.0+, watchOS 2.0+

相关用法

注：本文由纯净天空筛选整理自apple.com大神的英文原创作品 Collection subscript(_:)。非经特殊声明，原始代码版权归原作者所有，本译文未经允许或授权，请勿转载或复制。