方法（Methods）
本頁包含內容：
方法是與某些特定型別相關聯的函式。類別、結構、列舉都可以定義實例方法；實例方法為給定型別的實例封裝了具體的任務與功能。類別、結構、列舉也可以定義型別方法；型別方法與型別本身相關聯。型別方法與 Objective-C 中的類別方法（class methods）相似。
結構和列舉能夠定義方法是 Swift 與 C/Objective-C 的主要區別之一。在 Objective-C 中，類別是唯一能定義方法的型別。但在 Swift 中，你不僅能選擇是否要定義一個類別/結構/列舉，還能靈活的在你創建的型別（類別/結構/列舉）上定義方法。
實例方法(Instance Methods)
實例方法是屬於某個特定類別、結構或者列舉型別實例的方法。實例方法提供存取和修改實例屬性的方法或提供與實例目的相關的功能，並以此來支撐實例的功能。實例方法的語法與函式完全一致，詳情參見函式。
實例方法要寫在它所屬的型別的前後大括號之間。實例方法能夠隱式存取它所屬型別的所有的其他實例方法和屬性。實例方法只能被它所屬的類別的某個特定實例呼叫。實例方法不能脫離於現存的實例而被呼叫。
下面的範例，定義一個很簡單的類別Counter，Counter能被用來對一個動作發生的次數進行計數：
class Counter {
var count = 0
func increment() {
count++
}
func incrementBy(amount: Int) {
count += amount
}
func reset() {
count = 0
}
}
Counter類別定義了三個實例方法：
increment讓計數器按一遞增；incrementBy(amount: Int)讓計數器按一個指定的整數值遞增；reset將計數器重置為0。
Counter這個類別還宣告了一個可變屬性count，用它來保持對當前計數器值的追蹤。
和呼叫屬性一樣，用點語法（dot syntax）呼叫實例方法：
let counter = Counter()
// 初始計數值是0
counter.increment()
// 計數值現在是1
counter.incrementBy(5)
// 計數值現在是6
counter.reset()
// 計數值現在是0
方法的局部參數名稱和外部參數名稱(Local and External Parameter Names for Methods)
函式參數可以同時有一個局部名稱（在函式體內部使用）和一個外部名稱（在呼叫函式時使用），詳情參見函式的外部參數名。方法參數也一樣（因為方法就是函式，只是這個函式與某個型別相關聯了）。但是，方法和函式的局部名稱和外部名稱的預設行為是不一樣的。
Swift 中的方法和 Objective-C 中的方法極其相似。像在 Objective-C 中一樣，Swift 中方法的名稱通常用一個介詞指向方法的第一個參數，比如：with，for，by等等。前面的Counter類別的範例中incrementBy方法就是這樣的。介詞的使用讓方法在被呼叫時能像一個句子一樣被解讀。和函式參數不同，對於方法的參數，Swift 使用不同的預設處理方式，這可以讓方法命名規範更容易寫。
具體來說，Swift 預設僅給方法的第一個參數名稱一個局部參數名稱;預設同時給第二個和後續的參數名稱局部參數名稱和外部參數名稱。這個約定與典型的命名和呼叫約定相適應，與你在寫 Objective-C 的方法時很相似。這個約定還讓表達式方法在呼叫時不需要再限定參數名稱。
看看下面這個Counter的另一個版本（它定義了一個更複雜的incrementBy方法）：
class Counter {
var count: Int = 0
func incrementBy(amount: Int, numberOfTimes: Int) {
count += amount * numberOfTimes
}
}
incrementBy方法有兩個參數： amount和numberOfTimes。預設情況下，Swift 只把amount當作一個局部名稱，但是把numberOfTimes即看作局部名稱又看作外部名稱。下面呼叫這個方法：
let counter = Counter()
counter.incrementBy(5, numberOfTimes: 3)
// counter value is now 15
你不必為第一個參數值再定義一個外部變數名：因為從函式名incrementBy已經能很清楚地看出它的作用。但是第二個參數，就要被一個外部參數名稱所限定，以便在方法被呼叫時明確它的作用。
這種預設的行為能夠有效的處理方法（method）,類似於在參數numberOfTimes前寫一個井字號（#）：
func incrementBy(amount: Int, #numberOfTimes: Int) {
count += amount * numberOfTimes
}
這種預設行為使上面程式碼意味著：在 Swift 中定義方法使用了與 Objective-C 同樣的語法風格，並且方法將以自然表達式的方式被呼叫。
修改方法的外部參數名稱(Modifying External Parameter Name Behavior for Methods)
有時為方法的第一個參數提供一個外部參數名稱是非常有用的，儘管這不是預設的行為。你可以自己添加一個顯式的外部名稱或者用一個井字號（#）作為第一個參數的前綴來把這個局部名稱當作外部名稱使用。
相反，如果你不想為方法的第二個及後續的參數提供一個外部名稱，可以通過使用底線（_）作為該參數的顯式外部名稱，這樣做將覆蓋預設行為。
self屬性(The self Property)
型別的每一個實例都有一個隱含屬性叫做self，self完全等同於該實例本身。你可以在一個實例的實例方法中使用這個隱含的self屬性來參考當前實例。
上面範例中的increment方法還可以這樣寫：
func increment() {
self.count++
}
實際上，你不必在你的程式碼裡面經常寫self。不論何時，只要在一個方法中使用一個已知的屬性或者方法名稱，如果你沒有明確的寫self，Swift 假定你是指當前實例的屬性或者方法。這種假定在上面的Counter中已經示範了：Counter中的三個實例方法中都使用的是count（而不是self.count）。
使用這條規則的主要場景是實例方法的某個參數名稱與實例的某個屬性名稱相同的時候。在這種情況下，參數名稱享有優先權，並且在參考屬性時必須使用一種更嚴格的方式。這時你可以使用self屬性來區分參數名稱和屬性名稱。
下面的範例中，self消除方法參數x和實例屬性x之間的歧義：
struct Point {
var x = 0.0, y = 0.0
func isToTheRightOfX(x: Double) -> Bool {
return self.x > x
}
}
let somePoint = Point(x: 4.0, y: 5.0)
if somePoint.isToTheRightOfX(1.0) {
println("This point is to the right of the line where x == 1.0")
}
// 輸出 "This point is to the right of the line where x == 1.0"（這個點在x等於1.0這條線的右邊）
如果不使用self前綴，Swift 就認為兩次使用的x都指的是名稱為x的函式參數。
在實例方法中修改值型別(Modifying Value Types from Within Instance Methods)
結構和列舉是值型別。一般情況下，值型別的屬性不能在它的實例方法中被修改。
但是，如果你確實需要在某個具體的方法中修改結構或者列舉的屬性，你可以選擇變異(mutating)這個方法，然後方法就可以從方法內部改變它的屬性；並且它做的任何改變在方法結束時還會保留在原始結構中。方法還可以給它隱含的self屬性賦值一個全新的實例，這個新實例在方法結束後將替換原來的實例。
要使用變異方法， 將關鍵字mutating 放到方法的func關鍵字之前就可以了：
struct Point {
var x = 0.0, y = 0.0
mutating func moveByX(deltaX: Double, y deltaY: Double) {
x += deltaX
y += deltaY
}
}
var somePoint = Point(x: 1.0, y: 1.0)
somePoint.moveByX(2.0, y: 3.0)
println("The point is now at (\(somePoint.x), \(somePoint.y))")
// 輸出 "The point is now at (3.0, 4.0)"
上面的Point結構定義了一個變異方法（mutating method）moveByX，moveByX用來移動點。moveByX方法在被呼叫時修改了這個點，而不是回傳一個新的點。方法定義時加上mutating關鍵字,這才讓方法可以修改值型別的屬性。
注意：不能在結構型別常數上呼叫變異方法，因為常數的屬性不能被改變，即使想改變的是常數的變數屬性也不行，詳情參見儲存屬性和實例變數
let fixedPoint = Point(x: 3.0, y: 3.0)
fixedPoint.moveByX(2.0, y: 3.0)
// this will report an error
在變異方法中給self賦值(Assigning to self Within a Mutating Method)
變異方法能夠賦給隱含屬性self一個全新的實例。上面Point的範例可以用下面的方式改寫：
struct Point {
var x = 0.0, y = 0.0
mutating func moveByX(deltaX: Double, y deltaY: Double) {
self = Point(x: x + deltaX, y: y + deltaY)
}
}
新版的變異方法moveByX創建了一個新的結構（它的 x 和 y 的值都被設定為目標值）。呼叫這個版本的方法和呼叫上個版本的最終結果是一樣的。
列舉的變異方法可以把self設置為相同的列舉型別中不同的成員：
enum TriStateSwitch {
case Off, Low, High
mutating func next() {
switch self {
case Off:
self = Low
case Low:
self = High
case High:
self = Off
}
}
}
var ovenLight = TriStateSwitch.Low
ovenLight.next()
// ovenLight 現在等於 .High
ovenLight.next()
// ovenLight 現在等於 .Off
上面的範例中定義了一個三態開關的列舉。每次呼叫next方法時，開關在不同的電源狀態（Off，Low，High）之前迴圈切換。
型別方法(Type Methods)
實例方法是被型別的某個實例呼叫的方法。你也可以定義型別本身呼叫的方法，這種方法就叫做型別方法。宣告類別的型別方法，在方法的func關鍵字之前加上關鍵字class；宣告結構和列舉的型別方法，在方法的func關鍵字之前加上關鍵字static。
注意：
在 Objective-C 裡面，你只能為 Objective-C 的類別定義型別方法（type-level methods）。在 Swift 中，你可以為所有的類別、結構和列舉定義型別方法：每一個型別方法都被它所支援的型別顯式包含。
型別方法和實例方法一樣用點語法呼叫。但是，你是在型別層面上呼叫這個方法，而不是在實例層面上呼叫。下面是如何在SomeClass類別上呼叫型別方法的範例：
class SomeClass {
class func someTypeMethod() {
// type method implementation goes here
}
}
SomeClass.someTypeMethod()
在型別方法的方法體（body）中，self指向這個型別本身，而不是型別的某個實例。對於結構和列舉來說，這意味著你可以用self來消除靜態屬性和靜態方法參數之間的歧義（類似於我們在前面處理實例屬性和實例方法參數時做的那樣）。
一般來說，任何未限定的方法和屬性名稱，將會來自於本類別中另外的型別級別的方法和屬性。一個型別方法可以呼叫本類別中另一個型別方法的名稱，而無需在方法名稱前面加上型別名稱的前綴。同樣，結構和列舉的型別方法也能夠直接通過靜態屬性的名稱存取靜態屬性，而不需要型別名稱前綴。
下面的範例定義了一個名為LevelTracker結構。它監測玩家的遊戲發展情況（遊戲的不同層次或階段）。這是一個單人遊戲，但也可以儲存多個玩家在同一設備上的遊戲資訊。
遊戲初始時，所有的遊戲等級（除了等級 1）都被鎖定。每次有玩家完成一個等級，這個等級就對這個設備上的所有玩家解鎖。LevelTracker結構用靜態屬性和方法監測遊戲的哪個等級已經被解鎖。它還監測每個玩家的當前等級。
struct LevelTracker {
static var highestUnlockedLevel = 1
static func unlockLevel(level: Int) {
if level > highestUnlockedLevel { highestUnlockedLevel = level }
}
static func levelIsUnlocked(level: Int) -> Bool {
return level <= highestUnlockedLevel
}
var currentLevel = 1
mutating func advanceToLevel(level: Int) -> Bool {
if LevelTracker.levelIsUnlocked(level) {
currentLevel = level
return true
} else {
return false
}
}
}
LevelTracker監測玩家的已解鎖的最高等級。這個值被儲存在靜態屬性highestUnlockedLevel中。
LevelTracker還定義了兩個型別方法與highestUnlockedLevel配合工作。第一個型別方法是unlockLevel：一旦新等級被解鎖，它會更新highestUnlockedLevel的值。第二個型別方法是levelIsUnlocked：如果某個給定的等級已經被解鎖，它將回傳true。（注意：儘管我們沒有使用類似LevelTracker.highestUnlockedLevel的寫法，這個型別方法還是能夠存取靜態屬性highestUnlockedLevel）
除了靜態屬性和型別方法，LevelTracker還監測每個玩家的進度。它用實例屬性currentLevel來監測玩家當前的等級。
為了便於管理currentLevel屬性，LevelTracker定義了實例方法advanceToLevel。這個方法會在更新currentLevel之前檢查所請求的新等級是否已經解鎖。advanceToLevel方法回傳布林值以指示是否能夠設置currentLevel。
下面，Player類別使用LevelTracker來監測和更新每個玩家的發展進度：
class Player {
var tracker = LevelTracker()
let playerName: String
func completedLevel(level: Int) {
LevelTracker.unlockLevel(level + 1)
tracker.advanceToLevel(level + 1)
}
init(name: String) {
playerName = name
}
}
Player類別創建一個新的LevelTracker實例來監測這個使用者的發展進度。它提供了completedLevel方法：一旦玩家完成某個指定等級就呼叫它。這個方法為所有玩家解鎖下一等級，並且將當前玩家的進度更新為下一等級。（我們忽略了advanceToLevel回傳的布林值，因為之前呼叫LevelTracker.unlockLevel時就知道了這個等級已經被解鎖了）。
你還可以為一個新的玩家創建一個Player的實例，然後看這個玩家完成等級一時發生了什麼：
var player = Player(name: "Argyrios")
player.completedLevel(1)
println("highest unlocked level is now \(LevelTracker.highestUnlockedLevel)")
// 輸出 "highest unlocked level is now 2"（最高等級現在是2）
如果你創建了第二個玩家，並嘗試讓它開始一個沒有被任何玩家解鎖的等級，那麼這次設置玩家當前等級的嘗試將會失敗：
player = Player(name: "Beto")
if player.tracker.advanceToLevel(6) {
println("player is now on level 6")
} else {
println("level 6 has not yet been unlocked")
}
// 輸出 "level 6 has not yet been unlocked"（等級6還沒被解鎖）