Swift 下標腳本


下標腳本可以定義在類別(Class)、結構體(structure)和枚舉(enumeration)這些目標中,可以認為是存取物件、集合或序列的捷徑,不需要再呼叫實例的特定的賦值和存取方法。

舉例來說,用下標腳本存取一個陣列(Array)實例中的元素可以這樣寫 someArray[index] ,存取字典(Dictionary)實例中的元素可以這樣寫 someDictionary[key]。

對於同一個目標可以定義多個下標腳本,透過索引值類型的不同來進行重載,而且索引值的個數可以是多個。


下標腳本語法及應用

語法

下標腳本允許你透過在實例後面的方括號中傳入一個或多個的索引值來對實例進行存取和賦值。

語法類似於實例方法和計算型屬性的混合。

與定義實例方法類似,定義下標腳本使用subscript關鍵字,明確宣告入參(一個或多個)和傳回類型。

與實例方法不同的是下標腳本可以設定為讀寫或只讀。這種方式又有點像是計算型屬性的getter和setter:

subscript(index: Int) -> Int {
    get {
        // 用于下标脚本值的声明
    }
    set(newValue) {
        // 执行赋值操作
    }
}

實例1

import Cocoa

struct subexample {
    let decrementer: Int
    subscript(index: Int) -> Int {
        return decrementer / index
    }
}
let division = subexample(decrementer: 100)

print("100 除以 9 等于 \(division[9])")
print("100 除以 2 等于 \(division[2])")
print("100 除以 3 等于 \(division[3])")
print("100 除以 5 等于 \(division[5])")
print("100 除以 7 等于 \(division[7])")

以上程式執行輸出結果為:

100 除以 9 等于 11
100 除以 2 等于 50
100 除以 3 等于 33
100 除以 5 等于 20
100 除以 7 等于 14

在上例中,透過subexample 結構體建立了一個除法運算的實例。數值 100 以結構體建構函式傳入參數初始化實例成員 decrementer。

你可以透過下標腳本來得到結果,例如 division[2] 即為 100 除以 2。

實例 2

import Cocoa

class daysofaweek {
    private var days = ["Sunday", "Monday", "Tuesday", "Wednesday",
        "Thursday", "Friday", "saturday"]
    subscript(index: Int) -> String {
        get {
            return days[index]   // 声明下标脚本的值
        }
        set(newValue) {
            self.days[index] = newValue   // 执行赋值操作
        }
    }
}
var p = daysofaweek()

print(p[0])
print(p[1])
print(p[2])
print(p[3])

以上程式執行輸出結果為:

Sunday
Monday
Tuesday
Wednesday

用法

#根據使用場景不同下標腳本也具有不同的意義。

通常下標腳本是用來存取集合(collection),清單(list)或序列(sequence)中元素的捷徑。

你可以在你自己特定的類別或結構體中自由的實作下標腳本來提供合適的功能。

例如,Swift 的字典(Dictionary)實作了透過下標腳本對其實例中存放的值進行存取操作。在下標腳本中使用和字典索引相同類型的值,並且把一個字典值類型的值賦值給這個下標腳來為字典設值:

import Cocoa

var numberOfLegs = ["spider": 8, "ant": 6, "cat": 4]
numberOfLegs["bird"] = 2

print(numberOfLegs)

以上程式執行輸出結果為:

["ant": 6, "bird": 2, "cat": 4, "spider": 8]

上例定義一個名為numberOfLegs的變數並用一個字典字面量初始化出了包含三對鍵值的字典實例。 numberOfLegs的字典存放值類型推斷為Dictionary


下標腳本選項

下標腳本允許任意數量的入參索引,並且每個入參類型也沒有限制。

下標腳本的回傳值也可以是任何型別。

下標腳本可以使用變數參數和可變參數。

一個類別或結構體可以根據自身需求提供多個下標腳本實現,在定義下標腳本時透過傳入參數的類型進行區分,使用下標腳本時會自動匹配合適的下標腳本實作運行,這就是下標腳本的重載

import Cocoa

struct Matrix {
    let rows: Int, columns: Int
    var print: [Double]
    init(rows: Int, columns: Int) {
        self.rows = rows
        self.columns = columns
        print = Array(count: rows * columns, repeatedValue: 0.0)
    }
    subscript(row: Int, column: Int) -> Double {
        get {
            return print[(row * columns) + column]
        }
        set {
            print[(row * columns) + column] = newValue
        }
    }
}
// 创建了一个新的 3 行 3 列的Matrix实例
var mat = Matrix(rows: 3, columns: 3)

// 通过下标脚本设置值
mat[0,0] = 1.0
mat[0,1] = 2.0
mat[1,0] = 3.0
mat[1,1] = 5.0

// 通过下标脚本获取值
print("\(mat[0,0])")
print("\(mat[0,1])")
print("\(mat[1,0])")
print("\(mat[1,1])")

以上程式執行輸出結果為:

1.0
2.0
3.0
5.0

Matrix 結構體提供了一個兩個傳入參數的建構方法,兩個參數分別是rows和columns,創建了一個足夠容納rows * columns個數的Double型別陣列。為了存儲,將數組的大小和數組每個元素初始值0.0。

你可以透過傳入適當的row和column的數量來建構一個新的Matrix實例。