类,结构体,和枚举可以定义下标,是访问序列,类别,集合的成员元素的简写。使用下标通过索引设置和获取值而不需要为设置和获取分开方法。例如,用someArray[index]访问数组实例中的元素和用someDictionary[key]一样访问字典实例中的元素。
可以为一个类型定义多个下标,传给下标的索引值类型基础之上选择合适的下标的重载来使用。下标不局限于单个维度,你可以用多个输入参数来定义下标来适配你的自定义类型的需要。
下标语法(Subscript Syntax)
下标使你可以通过在实例名后面的方括号中写一个或者多个值来查询一个类的实例。他们的语法与实例方法语法和计算属性语法很相似。用subscript关键字来写下标的定义,指定一个或者多个输入参数和一个返回类型,和实例方法一样的方式。不像实例方法,下标可以使读写或者只读。这个表现和计算属性一样方式的getter和setter来表示:
subscript(index: Int) -> Int {
get {
// Return an appropriate subscript value here.
}
set(newValue) {
// Perform a suitable setting action here.
}
}newValue的类型和下标的返回值一样。就像计算属性,你可以选择不指定setter的(newValue)参数。一个默认的行为newValue的参数提供给你的setter,如果你自己没有提供一个的话。
像只读计算属性,你可以通过移除get关键字和它的花括号来简化只读下标的声明:
subscript(index: Int) -> Int {
// Return an appropriate subscript value here.
}这里是一个只读下标实现的例子,它定义了一个表示整型的一个n倍表的TimesTable结构体:
struct TimesTable {
let multiplier: Int
subscript(index: Int) -> Int {
return multiplier * index
}
}
let threeTimesTable = TimesTable(multiplier: 3)
print("six times three is \(threeTimesTable[6])")
// Prints "six times three is 18"在这个例子中,TimesTable的一个新实例创建来表示3倍数表。这从传了一个3给结构体的初始化方法用作实例的multiplier参数的值中可以看出来。
你可以通过调用它的下标来查询实例threeTimesTable,像调用threeTimesTable[6]中展示的。这请求了三倍表中的第六个实体,返回了值18,或者3倍的6.
一个n倍表在固定的数学定律基础之上。给threeTimesTable[someIndex]设置一个新值不合适,所以Timestable的下标定义为只读下标。
下标使用(Subscript Usage)
下标确切的意思依靠使用它的上下文。下标主要用作访问集合,列表或者序列的简写的简写。你可以自由地为你自己的指定类或者结构体的功能最合适的方式实现下标。
例如,swift的Dictionary类型实现了一个下标来设置和获取存储在Dictionary实例中的值。你可以通过在下标方括号中提供一个字典的key类型的key来在字典中设置一个值,并且给下标份额一个字典的值的类型的值:
var numberOfLegs = ["spider": 8, "ant": 6, "cat": 4]
numberOfLegs["bird"] = 2上面的例子定义了一个名为numberOfLegs的变量并且用一个包含三个key-value对的字典字面量来初始化了。numberOfLegs字典的类型推导为[String:Int]。在创建了字典之后,这个例子用下标分配来给字典增加一个String类型的key为bird和一个Int类型的值2。
关于字典下标的更多信息,查看Accessing and Modifying a Dictionary。
swift的Dictionary类型用一个下标实现他的key-value下标,使用和返回一个可选的类型。对于上面的numberOfLegs字典,key-value下标使用并返回了一个Int?类型或者”optional int“的值,字典类型使用可选的下标类型来模型花了不是每一个key都有值的事实,并且通过给那个key分配一个nil来给他一个删除key的value值的方式。
下标选项(Subscript Options)
下标可以接受任何数目的输入参数,这些输入参数可以是任何类型。下表也可以返回任何类型。下标可以使用可变参数,但是他们不能使用in-out参数或者提供默认参数值。
一个类或者结构体可以提供他需要的全部下标实现,要用的合适的下标将会在值的类型或者下标使用的地方的方块中包含的值来推导。这个多下标的定义名为重载。
对于下标来说采用一个参数是最常见的,如果对你的类型比较合适你也可以用多个参数定义一个下标。下面的例子定义了一个Matrix结构体,表示一个Double值的两维矩阵。Matrix结构体的下标采用了两个整型参数:
struct Matrix {
let rows: Int, columns: Int
var grid: [Double]
init(rows: Int, columns: Int) {
self.rows = rows
self.columns = columns
grid = Array(repeating: 0.0, count: rows * columns)
}
func indexIsValid(row: Int, column: Int) -> Bool {
return row >= 0 && row < rows && column >= 0 && column < columns
}
subscript(row: Int, column: Int) -> Double {
get {
assert(indexIsValid(row: row, column: column), "Index out of range")
return grid[(row * columns) + column]
}
set {
assert(indexIsValid(row: row, column: column), "Index out of range")
grid[(row * columns) + column] = newValue
}
}
}Matrix提供一个采用两个名为rows和columns的两个参数的初始化方法,并且创建了一个足够大来存储rows*columns个Double值的数组。矩阵中每个位置给一个初始化值0.0.为了达到这一点,数组的尺寸,和一个初始化cell值0.0,传给了一个创建和初始化正确尺寸的新的数组的数组初始化方法。这个初始化方法更多的描述细节在Creating an Array with a Default Value。
你可以通过传递一个合适的row和column数给他的初始化方法来构建一个新的Matrix实例:
var matrix = Matrix(rows: 2, columns: 2)上面的例子用两个rows和两个columns创建了一个新的Matrix实例。这个Matrix实例的grid数组是矩阵的一个有效的一维版本,像从上左读到右下:

矩阵中的值可以通过传到下标中用,分隔的row和column值来设置:
matrix[0, 1] = 1.5
matrix[1, 0] = 3.2这两个语句调用下标的setter来把矩阵中右上处的值设置为1.5(row是0,colum是1),并且左下位置设置为3.2(row是1,column是0):

Matrix下标的setter和getter都包含一个断言来检查下标的row和column的值是有效的。为了执行这些断言,Matrix包含一个名为indexIsValid(row:column:)的简便方法,检查请求的row和column是否在矩阵的范围之内:
func indexIsValid(row: Int, column: Int) -> Bool {
return row >= 0 && row < rows && column >= 0 && column < columns
}如果你尝试方位在矩阵范围之外的下标,断言会触发。
let someValue = matrix[2, 2]
// This triggers an assert, because [2, 2] is outside of the matrix bounds.类型下标(Type SubScripts)
实例下标,像上面描述的,是你在特定类型的实例上调用的。你也可以定义在类型上调用的下标。这种下标称为类型下标。通过在subscript关键字前面写static关键字来指定一个类型的下标。类型可以代替使用class关键字,来使子类重写父类的那个下标的实现。下面的例子展示了你如何定义和调用一个类型下标:
enum Planet: Int {
case mercury = 1, venus, earth, mars, jupiter, saturn, uranus, neptune
static subscript(n: Int) -> Planet {
return Planet(rawValue: n)!
}
}
let mars = Planet[4]
print(mars)