下标
下标(subscripts)可以定义在类(class)、结构体(structure)和枚举(enumeration)中,是访问集合(collection),列表(list)或序列(sequence)中元素的快捷方式。可以使用下标的索引,设置和获取值,而不需要再调用对应的存取方法。举例来说,用下标访问一个Array
实例中的元素可以写作someArray[index]
,访问Dictionary实例中的元素可以写作someDictionary[key]
。
一个类型可以定义多个下标,通过不同索引类型进行重载
。下标不限于一维,你可以定义具有多个入参的下标满足自定义类型的需求。
下标语法
下标允许你通过在实例名称后面的方括号中传入一个或者多个索引值来对实例进行存取。语法类似于实例方法语法和计算型属性语法的混合。与定义实例方法类似,定义下标使用subscript
关键字,指定一个或多个输入参数和返回类型;与实例方法不同的是,下标可以设定为读写或只读。这种行为由getter
和setter
实现,有点类似计算型属性:
如同计算型属性,可以不指定setter
的参数(newValue
)。如果不指定参数,setter
会提供一个名为newValue
的默认参数,newValue
的类型和下标的返回类型相同。
如同只读计算型属性,可以省略只读下标的get
关键字。
/** * 乘法表,基于数学公式,设置为只读。 */
struct TimesTable {
let multiplier: Int
subscript(index: Int) -> Int {
return index * multiplier
}
}
let t = TimesTable(multiplier: 5)
print(t[2]) // 10
print(t[100]) // 500
下标用法
下标的确切含义取决于使用场景。下标通常作为访问集合(collection),列表(list)或序列(sequence)中元素的快捷方式。你可以针对自己特定的类或结构体的功能来自由地以最恰当的方式实现下标。例如,Swift的Dictionary
类型实现下标用于对其实例中储存的值进行存取操作。为字典设值时,在下标中使用和字典的键类型相同的键,并把一个和字典的值类型相同的值赋给这个下标。、
Swift的Dictionary
类型的下标接受并返回可选类型的值。Dictionary
类型之所以如此实现下标,是因为不是每个键都有个对应的值,同时这也提供了一种通过键删除对应值的方式,只需将键对应的值赋值为nil
即可。
下标选项
下标可以接受任意数量的入参,并且这些入参可以是任意类型。下标的返回值也可以是任意类型。下标可以使用变量参数和可变参数,但不能使用输入输出参数,也不能给参数设置默认值。
一个类或结构体可以根据自身需要提供多个下标实现,使用下标时将通过入参的数量和类型进行区分,自动匹配合适的下标,这就是下标的重载
。虽然接受单一入参的下标是最常见的,但也可以根据情况定义接受多个入参的下标。
struct Matrix {
let rows: Int,colnums: Int
var grid: [Double] = []
init(rows: Int,colnums: Int) {
self.rows = rows
self.colnums = colnums
self.grid = Array(count: rows * colnums,repeatedValue: 0.0)
}
func indexIsValidForRow(row: Int,colnum: Int) -> Bool {
return row >= 0 && row < rows && colnum >= 0 && colnum < colnums
}
subscript(row: Int,colnum: Int) -> Double {
get {
assert(indexIsValidForRow(row,colnum: colnum),"Index out of range")
return grid[row * colnums + colnum]
}
set {
assert(indexIsValidForRow(row,"Index out of range")
grid[row * colnums + colnum] = newValue
}
}
}
var m = Matrix(rows: 3,colnums: 4)
print(m) // Matrix(rows: 3,colnums: 4,grid: [0.0,0.0,0.0])
m[0,3] = 100.0
m[1,2] = 98.5
print(m) // Matrix(rows: 3,100.0,98.5,0.0])
// print(m[3,3]) // assertion Failed: Index out of range: file <EXPR>,line 17