下標(biāo)腳本 可以定義在類(Class)、結(jié)構(gòu)體(structure)和枚舉(enumeration)這些目標(biāo)中,可以認(rèn)為是訪問對(duì)象、集合或序列的快捷方式,不需要再調(diào)用實(shí)例的特定的賦值和訪問方法。舉例來說,用下標(biāo)腳本訪問一個(gè)數(shù)組(Array)實(shí)例中的元素可以這樣寫 someArray[index]
,訪問字典(Dictionary)實(shí)例中的元素可以這樣寫 someDictionary[key]
。
對(duì)于同一個(gè)目標(biāo)可以定義多個(gè)下標(biāo)腳本,通過索引值類型的不同來進(jìn)行重載,而且索引值的個(gè)數(shù)可以是多個(gè)。
譯者:這里附屬腳本重載在本小節(jié)中原文并沒有任何演示
下標(biāo)腳本允許你通過在實(shí)例后面的方括號(hào)中傳入一個(gè)或者多個(gè)的索引值來對(duì)實(shí)例進(jìn)行訪問和賦值。語法類似于實(shí)例方法和計(jì)算型屬性的混合。與定義實(shí)例方法類似,定義下標(biāo)腳本使用subscript
關(guān)鍵字,顯式聲明入?yún)ⅲㄒ粋€(gè)或多個(gè))和返回類型。與實(shí)例方法不同的是下標(biāo)腳本可以設(shè)定為讀寫或只讀。這種方式又有點(diǎn)像計(jì)算型屬性的getter和setter:
subscript(index: Int) -> Int {
get {
// 返回與入?yún)⑵ヅ涞腎nt類型的值
}
set(newValue) {
// 執(zhí)行賦值操作
}
}
newValue
的類型必須和下標(biāo)腳本定義的返回類型相同。與計(jì)算型屬性相同的是set的入?yún)⒙暶?code>newValue就算不寫,在set代碼塊中依然可以使用默認(rèn)的newValue
這個(gè)變量來訪問新賦的值。
與只讀計(jì)算型屬性一樣,可以直接將原本應(yīng)該寫在get
代碼塊中的代碼寫在subscript
中:
subscript(index: Int) -> Int {
// 返回與入?yún)⑵ヅ涞腎nt類型的值
}
下面代碼演示了一個(gè)在TimesTable
結(jié)構(gòu)體中使用只讀下標(biāo)腳本的用法,該結(jié)構(gòu)體用來展示傳入整數(shù)的n倍。
struct TimesTable {
let multiplier: Int
subscript(index: Int) -> Int {
return multiplier * index
}
}
let threeTimesTable = TimesTable(multiplier: 3)
println("3的6倍是\(threeTimesTable[6])")
// 輸出 "3的6倍是18"
在上例中,通過TimesTable
結(jié)構(gòu)體創(chuàng)建了一個(gè)用來表示索引值三倍的實(shí)例。數(shù)值3
作為結(jié)構(gòu)體構(gòu)造函數(shù)
入?yún)⒊跏蓟瘜?shí)例成員multiplier
。
你可以通過下標(biāo)腳本來得到結(jié)果,比如threeTimesTable[6]
。這條語句訪問了threeTimesTable
的第六個(gè)元素,返回6
的3
倍即18
。
注意:
TimesTable
例子是基于一個(gè)固定的數(shù)學(xué)公式。它并不適合開放寫權(quán)限來對(duì)threeTimesTable[someIndex]
進(jìn)行賦值操作,這也是為什么附屬腳本只定義為只讀的原因。
根據(jù)使用場(chǎng)景不同下標(biāo)腳本也具有不同的含義。通常下標(biāo)腳本是用來訪問集合(collection),列表(list)或序列(sequence)中元素的快捷方式。你可以在你自己特定的類或結(jié)構(gòu)體中自由的實(shí)現(xiàn)下標(biāo)腳本來提供合適的功能。
例如,Swift 的字典(Dictionary)實(shí)現(xiàn)了通過下標(biāo)腳本來對(duì)其實(shí)例中存放的值進(jìn)行存取操作。在下標(biāo)腳本中使用和字典索引相同類型的值,并且把一個(gè)字典值類型的值賦值給這個(gè)下標(biāo)腳本來為字典設(shè)值:
var numberOfLegs = ["spider": 8, "ant": 6, "cat": 4]
numberOfLegs["bird"] = 2
上例定義一個(gè)名為numberOfLegs
的變量并用一個(gè)字典字面量初始化出了包含三對(duì)鍵值的字典實(shí)例。numberOfLegs
的字典存放值類型推斷為Dictionary<String, Int>
。字典實(shí)例創(chuàng)建完成之后通過下標(biāo)腳本的方式將整型值2
賦值到字典實(shí)例的索引為bird
的位置中。
更多關(guān)于字典(Dictionary)下標(biāo)腳本的信息請(qǐng)參考讀取和修改字典
注意:
Swift 中字典的附屬腳本實(shí)現(xiàn)中,在get
部分返回值是Int?
,上例中的numberOfLegs
字典通過附屬腳本返回的是一個(gè)Int?
或者說“可選的int”,不是每個(gè)字典的索引都能得到一個(gè)整型值,對(duì)于沒有設(shè)過值的索引的訪問返回的結(jié)果就是nil
;同樣想要從字典實(shí)例中刪除某個(gè)索引下的值也只需要給這個(gè)索引賦值為nil
即可。
下標(biāo)腳本允許任意數(shù)量的入?yún)⑺饕⑶颐總€(gè)入?yún)㈩愋鸵矝]有限制。下標(biāo)腳本的返回值也可以是任何類型。下標(biāo)腳本可以使用變量參數(shù)和可變參數(shù),但使用寫入讀出(in-out)參數(shù)或給參數(shù)設(shè)置默認(rèn)值都是不允許的。
一個(gè)類或結(jié)構(gòu)體可以根據(jù)自身需要提供多個(gè)下標(biāo)腳本實(shí)現(xiàn),在定義下標(biāo)腳本時(shí)通過入?yún)€(gè)類型進(jìn)行區(qū)分,使用下標(biāo)腳本時(shí)會(huì)自動(dòng)匹配合適的下標(biāo)腳本實(shí)現(xiàn)運(yùn)行,這就是下標(biāo)腳本的重載。
一個(gè)下標(biāo)腳本入?yún)⑹亲畛R姷那闆r,但只要有合適的場(chǎng)景也可以定義多個(gè)下標(biāo)腳本入?yún)?。如下例定義了一個(gè)Matrix
結(jié)構(gòu)體,將呈現(xiàn)一個(gè)Double
類型的二維矩陣。Matrix
結(jié)構(gòu)體的下標(biāo)腳本需要兩個(gè)整型參數(shù):
struct Matrix {
let rows: Int, columns: Int
var grid: [Double]
init(rows: Int, columns: Int) {
self.rows = rows
self.columns = columns
grid = Array(count: rows * columns, repeatedValue: 0.0)
}
func indexIsValidForRow(row: Int, column: Int) -> Bool {
return row >= 0 && row < rows && column >= 0 && column < columns
}
subscript(row: Int, column: Int) -> Double {
get {
assert(indexIsValidForRow(row, column: column), "Index out of range")
return grid[(row * columns) + column]
}
set {
assert(indexIsValidForRow(row, column: column), "Index out of range")
grid[(row * columns) + column] = newValue
}
}
}
Matrix
提供了一個(gè)兩個(gè)入?yún)⒌臉?gòu)造方法,入?yún)⒎謩e是rows
和columns
,創(chuàng)建了一個(gè)足夠容納rows * columns
個(gè)數(shù)的Double
類型數(shù)組。為了存儲(chǔ),將數(shù)組的大小和數(shù)組每個(gè)元素初始值0.0,都傳入數(shù)組的構(gòu)造方法中來創(chuàng)建一個(gè)正確大小的新數(shù)組。關(guān)于數(shù)組的構(gòu)造方法和析構(gòu)方法請(qǐng)參考創(chuàng)建并且構(gòu)造一個(gè)數(shù)組。
你可以通過傳入合適的row
和column
的數(shù)量來構(gòu)造一個(gè)新的Matrix
實(shí)例:
var matrix = Matrix(rows: 2, columns: 2)
上例中創(chuàng)建了一個(gè)新的兩行兩列的Matrix
實(shí)例。在閱讀順序從左上到右下的Matrix
實(shí)例中的數(shù)組實(shí)例grid
是矩陣二維數(shù)組的扁平化存儲(chǔ):
將值賦給帶有row
和column
下標(biāo)腳本的matrix
實(shí)例表達(dá)式可以完成賦值操作,下標(biāo)腳本入?yún)⑹褂枚禾?hào)分割
matrix[0, 1] = 1.5
matrix[1, 0] = 3.2
上面兩條語句分別讓matrix
的右上值為 1.5,坐下值為 3.2:
Matrix
下標(biāo)腳本的getter
和setter
中同時(shí)調(diào)用了下標(biāo)腳本入?yún)⒌?code>row和column
是否有效的判斷。為了方便進(jìn)行斷言,Matrix
包含了一個(gè)名為indexIsValid
的成員方法,用來確認(rèn)入?yún)⒌?code>row或column
值是否會(huì)造成數(shù)組越界:
func indexIsValidForRow(row: Int, column: Int) -> Bool {
return row >= 0 && row < rows && column >= 0 && column < columns
}
斷言在下標(biāo)腳本越界時(shí)觸發(fā):
let someValue = matrix[2, 2]
// 斷言將會(huì)觸發(fā),因?yàn)?[2, 2] 已經(jīng)超過了matrix的最大長(zhǎng)度
更多建議: