From 18a78500eab563d6766aa4fe35eb53fb1d14e1f8 Mon Sep 17 00:00:00 2001 From: Roger Chou Date: Wed, 2 Jul 2014 14:43:21 +0800 Subject: [PATCH] Revise the traditional Chinese translation in mds in the folder souce-tw & Using Swift with Cocoa and ObjectiveC-tw --- .../01Interacting with Objective-C APIs.md | 62 ++ .../03Mix and Match/DAG_2x.png | Bin 0 -> 25673 bytes ...ift and Objective-C in the Same Project.md | 0 .../03Mix and Match/bridgingheader_2x.png | Bin 0 -> 90275 bytes source-tw/README.md | 84 ++ source-tw/SUMMARY.md | 41 + source-tw/chapter1/01_swift.md | 17 + source-tw/chapter1/02_a_swift_tour.md | 726 +++++++++++++++ source-tw/chapter1/GuidedTour.playground.zip | Bin 0 -> 109631 bytes source-tw/chapter1/chapter1.md | 4 + source-tw/chapter2/01_The_Basics.md | 696 ++++++++++++++ source-tw/chapter2/02_Basic_Operators.md | 457 ++++++++++ .../chapter2/03_Strings_and_Characters.md | 409 +++++++++ source-tw/chapter2/04_Collection_Types.md | 428 +++++++++ source-tw/chapter2/05_Control_Flow.md | 726 +++++++++++++++ source-tw/chapter2/06_Functions.md | 573 ++++++++++++ source-tw/chapter2/07_Closures.md | 375 ++++++++ source-tw/chapter2/08_Enumerations.md | 251 +++++ .../chapter2/09_Classes_and_Structures.md | 443 +++++++++ source-tw/chapter2/10_Properties.md | 428 +++++++++ source-tw/chapter2/11_Methods.md | 309 +++++++ source-tw/chapter2/12_Subscripts.md | 167 ++++ source-tw/chapter2/13_Inheritance.md | 270 ++++++ source-tw/chapter2/14_Initialization.md | 646 +++++++++++++ source-tw/chapter2/15_Deinitialization.md | 108 +++ .../16_Automatic_Reference_Counting.md | 555 ++++++++++++ source-tw/chapter2/17_Optional_Chaining.md | 321 +++++++ source-tw/chapter2/18_Type_Casting.md | 252 ++++++ source-tw/chapter2/19_Nested_Types.md | 97 ++ source-tw/chapter2/20_Extensions.md | 300 ++++++ source-tw/chapter2/21_Protocols.md | 732 +++++++++++++++ source-tw/chapter2/22_Generics.md | 518 +++++++++++ source-tw/chapter2/23_Advanced_Operators.md | 484 ++++++++++ source-tw/chapter2/chapter2.md | 3 + .../01_About_the_Language_Reference.md | 38 + source-tw/chapter3/02_Lexical_Structure.md | 238 +++++ source-tw/chapter3/03_Types.md | 300 ++++++ source-tw/chapter3/04_Expressions.md | 637 +++++++++++++ source-tw/chapter3/05_Declarations.md | 855 ++++++++++++++++++ source-tw/chapter3/06_Attributes.md | 124 +++ source-tw/chapter3/07_Patterns.md | 182 ++++ .../08_Generic_Parameters_and_Arguments.md | 106 +++ .../chapter3/09_Summary_of_the_Grammar.md | 743 +++++++++++++++ source-tw/chapter3/10_Statements.md | 322 +++++++ source-tw/chapter3/chapter3.md | 0 source-tw/cover.jpg | Bin 0 -> 173792 bytes source-tw/cover_small.jpg | Bin 0 -> 9108 bytes 47 files changed, 14027 insertions(+) create mode 100644 Using Swift with Cocoa and ObjectiveC-tw/02Interoperability/01Interacting with Objective-C APIs.md create mode 100644 Using Swift with Cocoa and ObjectiveC-tw/03Mix and Match/DAG_2x.png create mode 100644 Using Swift with Cocoa and ObjectiveC-tw/03Mix and Match/Swift and Objective-C in the Same Project.md create mode 100644 Using Swift with Cocoa and ObjectiveC-tw/03Mix and Match/bridgingheader_2x.png create mode 100644 source-tw/README.md create mode 100644 source-tw/SUMMARY.md create mode 100644 source-tw/chapter1/01_swift.md create mode 100644 source-tw/chapter1/02_a_swift_tour.md create mode 100644 source-tw/chapter1/GuidedTour.playground.zip create mode 100644 source-tw/chapter1/chapter1.md create mode 100644 source-tw/chapter2/01_The_Basics.md create mode 100644 source-tw/chapter2/02_Basic_Operators.md create mode 100644 source-tw/chapter2/03_Strings_and_Characters.md create mode 100644 source-tw/chapter2/04_Collection_Types.md create mode 100644 source-tw/chapter2/05_Control_Flow.md create mode 100644 source-tw/chapter2/06_Functions.md create mode 100644 source-tw/chapter2/07_Closures.md create mode 100644 source-tw/chapter2/08_Enumerations.md create mode 100644 source-tw/chapter2/09_Classes_and_Structures.md create mode 100644 source-tw/chapter2/10_Properties.md create mode 100644 source-tw/chapter2/11_Methods.md create mode 100644 source-tw/chapter2/12_Subscripts.md create mode 100644 source-tw/chapter2/13_Inheritance.md create mode 100644 source-tw/chapter2/14_Initialization.md create mode 100644 source-tw/chapter2/15_Deinitialization.md create mode 100644 source-tw/chapter2/16_Automatic_Reference_Counting.md create mode 100644 source-tw/chapter2/17_Optional_Chaining.md create mode 100644 source-tw/chapter2/18_Type_Casting.md create mode 100644 source-tw/chapter2/19_Nested_Types.md create mode 100644 source-tw/chapter2/20_Extensions.md create mode 100644 source-tw/chapter2/21_Protocols.md create mode 100644 source-tw/chapter2/22_Generics.md create mode 100644 source-tw/chapter2/23_Advanced_Operators.md create mode 100644 source-tw/chapter2/chapter2.md create mode 100644 source-tw/chapter3/01_About_the_Language_Reference.md create mode 100644 source-tw/chapter3/02_Lexical_Structure.md create mode 100644 source-tw/chapter3/03_Types.md create mode 100644 source-tw/chapter3/04_Expressions.md create mode 100644 source-tw/chapter3/05_Declarations.md create mode 100644 source-tw/chapter3/06_Attributes.md create mode 100644 source-tw/chapter3/07_Patterns.md create mode 100644 source-tw/chapter3/08_Generic_Parameters_and_Arguments.md create mode 100644 source-tw/chapter3/09_Summary_of_the_Grammar.md create mode 100644 source-tw/chapter3/10_Statements.md create mode 100644 source-tw/chapter3/chapter3.md create mode 100644 source-tw/cover.jpg create mode 100644 source-tw/cover_small.jpg diff --git a/Using Swift with Cocoa and ObjectiveC-tw/02Interoperability/01Interacting with Objective-C APIs.md b/Using Swift with Cocoa and ObjectiveC-tw/02Interoperability/01Interacting with Objective-C APIs.md new file mode 100644 index 00000000..5e51887d --- /dev/null +++ b/Using Swift with Cocoa and ObjectiveC-tw/02Interoperability/01Interacting with Objective-C APIs.md @@ -0,0 +1,62 @@ +# 個人信息 + +梁傑，男，北京航空航天大學，大三。 + +熱愛Python，喜歡前端，GitHub重度腦殘粉，目前正在維護swiftist.org社區。 + +# 時間點 + +6.3 項目發佈 第一天僅有50Star +6.4 開始有人關注 300+Star +6.5~6.6 翻譯工作開始步入正軌 +6.7~6.8 翻譯速度一般 +6.9~6.11 建立QQ群 翻譯速度加快 完成翻譯 初步校對 +6.12 發佈 + +# 發起原因 + +最初其實沒想到會做成這樣，只是想著既然Swift這麼火，我也想學一學，不如用點心去翻譯一下，讓我們廣大群眾也懂得一些知識，也算是為大家做點貢獻。 + +萬萬沒想到，最後變成了一個這麼大的開源協作項目。 + +# 協作形式 + +通過GitHub進行協作，文章使用markdown寫成，用gitbook製作成靜態頁面並托管在GitHub上，可以直接在線閱讀。markdown也可以轉換成Epub、PDF、mobi等多種電子書格式。 + +參與翻譯的朋友只需要更新markdown文件內容即可，我會將內容通過gitbook轉換成頁面並更新到GitHub。 + +# 如何吸引譯者 + +項目發起之後我只是在自己的微博上提了一下，開始時候並沒有什麼人關注，不過經過一些大號轉發之後關注的人越來越多，就開始有人參與進來。 + +其實能吸引到這麼多人，主要還是因為蘋果的影響力太大，再加上我發起項目的時間非常早，正是全民Swift的時候，所以吸引了很多人參與。 + +# 如何組織開源翻譯 + +## 讓新手也能參與 + +GitHub在國內的普及程度還是不夠，很多有興趣參與的朋友都不太會用。剛開始我也沒有意識到這個問題，直到有一個朋友主動問我我才明白過來，迅速在項目首頁的說明中添加了詳細的貢獻代碼教程。實踐證明很多朋友都是照著這個教程完成了工作。 + +## 傳達信息 + +組織開源項目最重要的一點就是保證信息的傳達，其實秘訣很簡單——重複說。 + +就拿 Swift 這本書來舉例，我一直在項目說明中更新當前進度，按理說大家點進來都會立刻看到，但是仍然有很多朋友問我現在翻譯了多少、還有沒有未認領章節。之後我就開始主動通知大家，在所有能通知的地方通知，一旦有新變動就馬上通知，慢慢的就沒有人問我了，因為大家都很清楚項目進度。 + +重要的信息比如時間節點，一定要多次強調。剛開始的一段時間雖然章節很快被認領，但是完成的人很少。後來我開始在群裡說，週三完成翻譯開始校對，一天說了有十幾遍吧，然後從第二天開始完成的人就越來越多。 + +大家參與開源項目時相對來說是比較被動的，如果你希望控制時間的話，一定要多次強調，把這個信息發送到每個人的潛意識裡。 + +## 把握發展方向 + +很多人會參與進來，但是幾乎沒人會主動考慮這個項目該如何發展，一定要記住這一點。 + +如果你覺得很多人參與進來你就可以休息的話，那就大錯特錯了，大家擅長幫忙，但並不擅長主導項目。所以你要時刻提醒自己，下一步的目標是什麼？我們應該怎麼去做？主動提出一個方案然後和大家討論，千萬不要提出一個問題然後等待答案。 + +# 一點感想 + +還是那句話，萬萬沒想到。 + +第一天我還在和朋友說，我真羨慕別人的項目，有200多個Star，結果第二天我自己的項目就有了300多個Star，第三天600多……開始時候其實是抱著「做做試試」的心態來翻譯，但是當Star和譯者多起來之後，翻譯完成就變成了一個責任，你肩負的是所有人的努力，一定不能讓大家失望。 + +這大概是我21年來做得最大的一件事。 diff --git a/Using Swift with Cocoa and ObjectiveC-tw/03Mix and Match/DAG_2x.png b/Using Swift with Cocoa and ObjectiveC-tw/03Mix and Match/DAG_2x.png new file mode 100644 index 0000000000000000000000000000000000000000..3c15390bf0e9456e202a042294d30c8fc83a258a GIT binary patch literal 25673 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 literal 0 HcmV?d00001 diff --git a/Using Swift with Cocoa and ObjectiveC-tw/03Mix and Match/Swift and Objective-C in the Same Project.md b/Using Swift with Cocoa and ObjectiveC-tw/03Mix and Match/Swift and Objective-C in the Same Project.md new file mode 100644 index 00000000..e69de29b diff --git a/Using Swift with Cocoa and ObjectiveC-tw/03Mix and Match/bridgingheader_2x.png b/Using Swift with Cocoa and ObjectiveC-tw/03Mix and Match/bridgingheader_2x.png new file mode 100644 index 0000000000000000000000000000000000000000..0e678eec5571e04f9156d3e3a8d275a4294ab367 GIT binary patch literal 90275 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 Swift 興趣交流群：`305014012`，307017261（已滿） +> [Swift 開發者社區](http://swiftist.org) + + +> 如果你覺得這個項目不錯，請[點擊Star一下](https://github.com/numbbbbb/the-swift-programming-language-in-chinese)，您的支持我們最大的動力。 + +# The Swift Programming Language 中文版 + +###這一次，讓中國和世界同步 + +現在是6月12日凌晨4:38，我用了整整一晚上的時間來進行最後的校對，終於可以在12日拿出一個可以發佈的版本。 + +9天時間，1317個 Star，310個 Fork，超過30人參與翻譯和校對工作，項目最高排名GitHub總榜第4。 + +設想過很多遍校對完成時的場景，仰天大笑還是淚流滿面？真正到了這一刻才發現，疲倦已經不允許我有任何情緒。 + +說實話，剛開始發起項目的時候完全沒想到會發展成今天這樣，我一度計劃自己一個人翻譯完整本書。萬萬沒想到，會有這麼多的人願意加入並貢獻出自己的力量。 + +coverxit發給我最後一份文檔的時候說，我要去背單詞了，我問他，週末要考六級？他說是的。 + +pp-prog告訴我，這幾天太累了，校對到一半睡著了，醒來又繼續做。2點17分，發給我校對完成的文檔。 + +lifedim說他平時12點就會睡，1點47分，發給我校對後的文檔。 + +團隊裡每個人都有自己的事情，上班、上學、創業，但是我們只用了9天就完成整本書的翻譯。我不知道大家付出了多少，犧牲了多少，但是我知道，他們的付出必將被這些文字記錄下來，即使再過10年，20年，依然熠熠生輝，永不被人遺忘。 + +全體人員名單（排名不分先後）： + +- [numbbbbb](https://github.com/numbbbbb) +- [stanzhai](https://github.com/stanzhai) +- [coverxit](https://github.com/coverxit) +- [wh1100717](https://github.com/wh1100717) +- [TimothyYe](https://github.com/TimothyYe) +- [honghaoz](https://github.com/honghaoz) +- [lyuka](https://github.com/lyuka) +- [JaySurplus](https://github.com/JaySurplus) +- [Hawstein](https://github.com/Hawstein) +- [geek5nan](https://github.com/geek5nan) +- [yankuangshi](https://github.com/yankuangshi) +- [xielingwang](https://github.com/xielingwang) +- [yulingtianxia](https://github.com/yulingtianxia) +- [twlkyao](https://github.com/twlkyao) +- [dabing1022](https://github.com/dabing1022) +- [vclwei](https://github.com/vclwei) +- [fd5788](https://github.com/fd5788) +- [siemenliu](https://github.com/siemenliu) +- [youkugems](https://github.com/youkugems) +- [haolloyin](https://github.com/haolloyin) +- [wxstars](https://github.com/wxstars) +- [IceskYsl](https://github.com/IceskYsl) +- [sg552](https://github.com/sg552) +- [superkam](https://github.com/superkam) +- [zac1st1k](https://github.com/zac1st1k) +- [bzsy](https://github.com/bzsy) +- [pyanfield](https://github.com/pyanfield) +- [ericzyh](https://github.com/ericzyh) +- [peiyucn](https://github.com/peiyucn) +- [sunfiled](https://github.com/sunfiled) +- [lzw120](https://github.com/lzw120) +- [viztor](https://github.com/viztor) +- [wongzigii](https://github.com/wongzigii) +- [umcsdon](https://github.com/umcsdon) +- [zq54zquan](https://github.com/zq54zquan) +- [xiehurricane](https://github.com/xiehurricane) +- [Jasonbroker](https://github.com/Jasonbroker) +- [tualatrix](https://github.com/tualatrix) +- [pp-prog](https://github.com/pp-prog) +- [088haizi](https://github.com/088haizi) +- [baocaixiong](https://github.com/baocaixiong) +- [yeahdongcn](https://github.com/yeahdongcn) +- [shinyzhu](https://github.com/shinyzhu) +- [lslxdx](https://github.com/lslxdx) +- [Evilcome](https://github.com/Evilcome) +- [zqp](https://github.com/zqp) +- [NicePiao](https://github.com/NicePiao) +- [LunaticM](https://github.com/LunaticM) +- [menlongsheng](https://github.com/menlongsheng) +- [lifedim](https://github.com/lifedim) +- [happyming](https://github.com/happyming) +- [bruce0505](https://github.com/bruce0505) +- [Lin-H](https://github.com/Lin-H) +- [takalard](https://github.com/takalard) +- [dabing1022](https://github.com/dabing1022) +- [marsprince](https://github.com/marsprince) diff --git a/source-tw/SUMMARY.md b/source-tw/SUMMARY.md new file mode 100644 index 00000000..2c410c00 --- /dev/null +++ b/source-tw/SUMMARY.md @@ -0,0 +1,41 @@ +# Summary + +* [歡迎使用 Swift](chapter1/chapter1.md) + * [關於 Swift](chapter1/01_swift.md) + * [Swift 初見](chapter1/02_a_swift_tour.md) +* [Swift 教程](chapter2/chapter2.md) + * [基礎部分](chapter2/01_The_Basics.md) + * [基本運算符](chapter2/02_Basic_Operators.md) + * [字符串和字符](chapter2/03_Strings_and_Characters.md) + * [集合類型](chapter2/04_Collection_Types.md) + * [控制流](chapter2/05_Control_Flow.md) + * [函數](chapter2/06_Functions.md) + * [閉包](chapter2/07_Closures.md) + * [枚舉](chapter2/08_Enumerations.md) + * [類和結構體](chapter2/09_Classes_and_Structures.md) + * [屬性](chapter2/10_Properties.md) + * [方法](chapter2/11_Methods.md) + * [下標腳本](chapter2/12_Subscripts.md) + * [繼承](chapter2/13_Inheritance.md) + * [構造過程](chapter2/14_Initialization.md) + * [析構過程](chapter2/15_Deinitialization.md) + * [自動引用計數](chapter2/16_Automatic_Reference_Counting.md) + * [可選鏈](chapter2/17_Optional_Chaining.md) + * [類型檢查](chapter2/18_Type_Casting.md) + * [嵌套類型](chapter2/19_Nested_Types.md) + * [擴展](chapter2/20_Extensions.md) + * [協議](chapter2/21_Protocols.md) + * [泛型](chapter2/22_Generics.md) + * [高級操作符](chapter2/23_Advanced_Operators.md) +* [語言參考](chapter3/chapter3.md) + * [關於語言參考](chapter3/01_About_the_Language_Reference.md) + * [詞法結構](chapter3/02_Lexical_Structure.md) + * [類型](chapter3/03_Types.md) + * [表達式](chapter3/04_Expressions.md) + * [語句](chapter3/10_Statements.md) + * [聲明](chapter3/05_Declarations.md) + * [特性](chapter3/06_Attributes.md) + * [模式](chapter3/07_Patterns.md) + * [泛型參數](chapter3/08_Generic_Parameters_and_Arguments.md) + * [語法總結](chapter3/09_Summary_of_the_Grammar.md) + diff --git a/source-tw/chapter1/01_swift.md b/source-tw/chapter1/01_swift.md new file mode 100644 index 00000000..3b5536ed --- /dev/null +++ b/source-tw/chapter1/01_swift.md @@ -0,0 +1,17 @@ +> 翻譯：[numbbbbb](https://github.com/numbbbbb) +> 校對：[yeahdongcn](https://github.com/yeahdongcn) + +# 關於 Swift +----------------- + +Swift 是一種新的編程語言，用於編寫 iOS 和 OS X 應用。Swift 結合了 C 和 Objective-C 的優點並且不受 C 兼容性的限制。Swift 採用安全的編程模式並添加了很多新特性，這將使編程更簡單，更靈活，也更有趣。Swift 是基於成熟而且倍受喜愛的 Cocoa 和 Cocoa Touch 框架，它的降臨將重新定義軟件開發。 + +Swift 的開發從很久之前就開始了。為了給 Swift 打好基礎，蘋果公司改進了編譯器，調試器和框架結構。我們使用自動引用計數（Automatic Reference Counting, ARC）來簡化內存管理。我們在 Foundation 和 Cocoa 的基礎上構建框架棧並將其標準化。Objective-C 本身支持塊、集合語法和模塊，所以框架可以輕鬆支持現代編程語言技術。正是得益於這些基礎工作，我們現在才能發佈這樣一個用於未來蘋果軟件開發的新語言。 + +Objective-C 開發者對 Swift 並不會感到陌生。它採用了 Objective-C 的命名參數以及動態對像模型，可以無縫對接到現有的 Cocoa 框架，並且可以兼容 Objective-C 代碼。在此基礎之上，Swift 還有許多新特性並且支持過程式編程和面向對像編程。 + +Swift 對於初學者來說也很友好。它是第一個既滿足工業標準又像腳本語言一樣充滿表現力和趣味的編程語言。它支持代碼預覽，這個革命性的特性可以允許程序員在不編譯和運行應用程序的前提下運行 Swift 代碼並實時查看結果。 + +Swift 將現代編程語言的精華和蘋果工程師文化的智慧結合了起來。編譯器對性能進行了優化，編程語言對開發進行了優化，兩者互不干擾，魚與熊掌兼得。Swift 既可以用於開發 「hello, world」 這樣的小程序，也可以用於開發一套完整的操作系統。所有的這些特性讓 Swift 對於開發者和蘋果來說都是一項值得的投資。 + +Swift 是編寫 iOS 和 OS X 應用的極佳手段，並將伴隨著新的特性和功能持續演進。我們對 Swift 充滿信心，你還在等什麼！ diff --git a/source-tw/chapter1/02_a_swift_tour.md b/source-tw/chapter1/02_a_swift_tour.md new file mode 100644 index 00000000..cb254464 --- /dev/null +++ b/source-tw/chapter1/02_a_swift_tour.md @@ -0,0 +1,726 @@ +> 翻譯：[numbbbbb](https://github.com/numbbbbb) +> 校對：[shinyzhu](https://github.com/shinyzhu), [stanzhai](https://github.com/stanzhai) + +# Swift 初見 + +--- + +本頁內容包括： + +- [簡單值（Simple Values）](#simple_values) +- [控制流（Control Flow）](#control_flow) +- [函數和閉包（Functions and Closures）](#functions_and_closures) +- [對像和類（Objects and Classes）](#objects_and_classes) +- [枚舉和結構體（Enumerations and Structures）](#enumerations_and_structures) +- [協議和擴展（Protocols and Extensions）](#protocols_and_extensions) +- [泛型（Generics）](#generics) + +通常來說，編程語言教程中的第一個程序應該在屏幕上打印「Hello, world」。在 Swift 中，可以用一行代碼實現： + +```swift +println("Hello, world") +``` + +如果你寫過 C 或者 Objective-C 代碼，那你應該很熟悉這種形式——在 Swift 中，這行代碼就是一個完整的程序。你不需要為了輸入輸出或者字符串處理導入一個單獨的庫。全局作用域中的代碼會被自動當做程序的入口點，所以你也不需要`main`函數。你同樣不需要在每個語句結尾寫上分號。 + +這個教程會通過一系列編程例子來讓你對 Swift 有初步瞭解，如果你有什麼不理解的地方也不用擔心——任何本章介紹的內容都會在後面的章節中詳細講解。 + +> 注意： +> 為了獲得最好的體驗，在 Xcode 當中使用代碼預覽功能。代碼預覽功能可以讓你編輯代碼並實時看到運行結果。 +> 打開Playground + + +## 簡單值 + +使用`let`來聲明常量，使用`var`來聲明變量。一個常量的值，在編譯的時候，並不需要有明確的值，但是你只能為它賦值一次。也就是說你可以用常量來表示這樣一個值：你只需要決定一次，但是需要使用很多次。 + +```swift +var myVariable = 42 +myVariable = 50 +let myConstant = 42 +``` + +常量或者變量的類型必須和你賦給它們的值一樣。然而，聲明時類型是可選的，聲明的同時賦值的話，編譯器會自動推斷類型。在上面的例子中，編譯器推斷出`myVariable`是一個整數（integer）因為它的初始值是整數。 + +如果初始值沒有提供足夠的信息（或者沒有初始值），那你需要在變量後面聲明類型，用冒號分割。 + +```swift +let implicitInteger = 70 +let implicitDouble = 70.0 +let explicitDouble: Double = 70 +``` + +> 練習： +> 創建一個常量，顯式指定類型為`Float`並指定初始值為4。 + +值永遠不會被隱式轉換為其他類型。如果你需要把一個值轉換成其他類型，請顯式轉換。 + +```swift +let label = "The width is" +let width = 94 +let widthLabel = label + String(width) +``` +> 練習： +> 刪除最後一行中的`String`，錯誤提示是什麼？ + +有一種更簡單的把值轉換成字符串的方法：把值寫到括號中，並且在括號之前寫一個反斜槓。例如： + +```swift +let apples = 3 +let oranges = 5 +let appleSummary = "I have \(apples) apples." +let fruitSummary = "I have \(apples + oranges) pieces of fruit." +``` + +> 練習： +> 使用`\()`來把一個浮點計算轉換成字符串，並加上某人的名字，和他打個招呼。 + +使用方括號`[]`來創建數組和字典，並使用下標或者鍵（key）來訪問元素。 + +```swift +var shoppingList = ["catfish", "water", "tulips", "blue paint"] +shoppingList[1] = "bottle of water" +``` + +```swift +var occupations = [ + "Malcolm": "Captain", + "Kaylee": "Mechanic", +] +occupations["Jayne"] = "Public Relations" +``` + +要創建一個空數組或者字典，使用初始化語法。 + +```swift +let emptyArray = String[]() +let emptyDictionary = Dictionary() +``` + +如果類型信息可以被推斷出來，你可以用`[]`和`[:]`來創建空數組和空字典——就像你聲明變量或者給函數傳參數的時候一樣。 + +```swift +shoppingList = [] // 去逛街並買點東西 +``` + + +## 控制流 + +使用`if`和`switch`來進行條件操作，使用`for-in`、`for`、`while`和`do-while`來進行循環。包裹條件和循環變量括號可以省略，但是語句體的大括號是必須的。 + +```swift +let individualScores = [75, 43, 103, 87, 12] +var teamScore = 0 +for score in individualScores { + if score > 50 { + teamScore += 3 + } else { + teamScore += 1 + } +} +teamScore +``` + +在`if`語句中，條件必須是一個布爾表達式——這意味著像`if score { ... }`這樣的代碼將報錯，而不會隱形地與 0 做對比。 + +你可以一起使用`if`和`let`來處理值缺失的情況。有些變量的值是可選的。一個可選的值可能是一個具體的值或者是`nil`，表示值缺失。在類型後面加一個問號來標記這個變量的值是可選的。 + +```swift +var optionalString: String? = "Hello" +optionalString == nil + +var optionalName: String? = "John Appleseed" +var greeting = "Hello!" +if let name = optionalName { + greeting = "Hello, \(name)" +} +``` + +> 練習： +> 把`optionalName`改成`nil`，greeting會是什麼？添加一個`else`語句，當`optionalName`是`nil`時給greeting賦一個不同的值。 + +如果變量的可選值是`nil`，條件會判斷為`false`，大括號中的代碼會被跳過。如果不是`nil`，會將值賦給`let`後面的常量，這樣代碼塊中就可以使用這個值了。 + +`switch`支持任意類型的數據以及各種比較操作——不僅僅是整數以及測試相等。 + +```swift +let vegetable = "red pepper" +switch vegetable { +case "celery": + let vegetableComment = "Add some raisins and make ants on a log." +case "cucumber", "watercress": + let vegetableComment = "That would make a good tea sandwich." +case let x where x.hasSuffix("pepper"): + let vegetableComment = "Is it a spicy \(x)?" +default: + let vegetableComment = "Everything tastes good in soup." +} +``` + +> 練習： +> 刪除`default`語句，看看會有什麼錯誤？ + +運行`switch`中匹配到的子句之後，程序會退出`switch`語句，並不會繼續向下運行，所以不需要在每個子句結尾寫`break`。 + +你可以使用`for-in`來遍歷字典，需要兩個變量來表示每個鍵值對。 + +```swift +let interestingNumbers = [ + "Prime": [2, 3, 5, 7, 11, 13], + "Fibonacci": [1, 1, 2, 3, 5, 8], + "Square": [1, 4, 9, 16, 25], +] +var largest = 0 +for (kind, numbers) in interestingNumbers { + for number in numbers { + if number > largest { + largest = number + } + } +} +largest +``` + +> 練習： +> 添加另一個變量來記錄哪種類型的數字是最大的。 + +使用`while`來重複運行一段代碼直到不滿足條件。循環條件可以在開頭也可以在結尾。 + +```swift +var n = 2 +while n < 100 { + n = n * 2 +} +n + +var m = 2 +do { + m = m * 2 +} while m < 100 +m +``` + +你可以在循環中使用`..`來表示範圍，也可以使用傳統的寫法，兩者是等價的： + +```swift +var firstForLoop = 0 +for i in 0..3 { + firstForLoop += i +} +firstForLoop + +var secondForLoop = 0 +for var i = 0; i < 3; ++i { + secondForLoop += 1 +} +secondForLoop +``` + +使用`..`創建的範圍不包含上界，如果想包含的話需要使用`...`。 + + +## 函數和閉包 + +使用`func`來聲明一個函數，使用名字和參數來調用函數。使用`->`來指定函數返回值。 + +```swift +func greet(name: String, day: String) -> String { + return "Hello \(name), today is \(day)." +} +greet("Bob", "Tuesday") +``` + +> 練習： +> 刪除`day`參數，添加一個參數來表示今天吃了什麼午飯。 + +使用一個元組來返回多個值。 + +```swift +func getGasPrices() -> (Double, Double, Double) { + return (3.59, 3.69, 3.79) +} +getGasPrices() +``` + +函數可以帶有可變個數的參數，這些參數在函數內表現為數組的形式： + +```swift +func sumOf(numbers: Int...) -> Int { + var sum = 0 + for number in numbers { + sum += number + } + return sum +} +sumOf() +sumOf(42, 597, 12) +``` + +> 練習： +> 寫一個計算參數平均值的函數。 + +函數可以嵌套。被嵌套的函數可以訪問外側函數的變量，你可以使用嵌套函數來重構一個太長或者太複雜的函數。 + +```swift +func returnFifteen() -> Int { + var y = 10 + func add() { + y += 5 + } + add() + return y +} +returnFifteen() +``` + +函數是第一等類型，這意味著函數可以作為另一個函數的返回值。 + +```swift +func makeIncrementer() -> (Int -> Int) { + func addOne(number: Int) -> Int { + return 1 + number + } + return addOne +} +var increment = makeIncrementer() +increment(7) +``` + +函數也可以當做參數傳入另一個函數。 + +```swift +func hasAnyMatches(list: Int[], condition: Int -> Bool) -> Bool { + for item in list { + if condition(item) { + return true + } + } + return false +} +func lessThanTen(number: Int) -> Bool { + return number < 10 +} +var numbers = [20, 19, 7, 12] +hasAnyMatches(numbers, lessThanTen) +``` + +函數實際上是一種特殊的閉包，你可以使用`{}`來創建一個匿名閉包。使用`in`將參數和返回值類型聲明與閉包涵數體進行分離。 + +```swift +numbers.map({ + (number: Int) -> Int in + let result = 3 * number + return result +}) +``` + +> 練習： +> 重寫閉包，對所有奇數返回0。 + +有很多種創建閉包的方法。如果一個閉包的類型已知，比如作為一個回調函數，你可以忽略參數的類型和返回值。單個語句閉包會把它語句的值當做結果返回。 + +```swift +numbers.map({ number in 3 * number }) +``` + +你可以通過參數位置而不是參數名字來引用參數——這個方法在非常短的閉包中非常有用。當一個閉包作為最後一個參數傳給一個函數的時候，它可以直接跟在括號後面。 + +```swift +sort([1, 5, 3, 12, 2]) { $0 > $1 } +``` + + +## 對像和類 + +使用`class`和類名來創建一個類。類中屬性的聲明和常量、變量聲明一樣，唯一的區別就是它們的上下文是類。同樣，方法和函數聲明也一樣。 + +```swift +class Shape { + var numberOfSides = 0 + func simpleDescription() -> String { + return "A shape with \(numberOfSides) sides." + } +} +``` + +> 練習： +> 使用`let`添加一個常量屬性，再添加一個接收一個參數的方法。 + +要創建一個類的實例，在類名後面加上括號。使用點語法來訪問實例的屬性和方法。 + +```swift +var shape = Shape() +shape.numberOfSides = 7 +var shapeDescription = shape.simpleDescription() +``` + +這個版本的`Shape`類缺少了一些重要的東西：一個構造函數來初始化類實例。使用`init`來創建一個構造器。 + +```swift +class NamedShape { + var numberOfSides: Int = 0 + var name: String + + init(name: String) { + self.name = name + } + + func simpleDescription() -> String { + return "A shape with \(numberOfSides) sides." + } +} +``` + +注意`self`被用來區別實例變量。當你創建實例的時候，像傳入函數參數一樣給類傳入構造器的參數。每個屬性都需要賦值——無論是通過聲明（就像`numberOfSides`）還是通過構造器（就像`name`）。 + +如果你需要在刪除對像之前進行一些清理工作，使用`deinit`創建一個析構函數。 + +子類的定義方法是在它們的類名後面加上父類的名字，用冒號分割。創建類的時候並不需要一個標準的根類，所以你可以忽略父類。 + +子類如果要重寫父類的方法的話，需要用`override`標記——如果沒有添加`override`就重寫父類方法的話編譯器會報錯。編譯器同樣會檢測`override`標記的方法是否確實在父類中。 + +```swift +class Square: NamedShape { + var sideLength: Double + + init(sideLength: Double, name: String) { + self.sideLength = sideLength + super.init(name: name) + numberOfSides = 4 + } + + func area() -> Double { + return sideLength * sideLength + } + + override func simpleDescription() -> String { + return "A square with sides of length \(sideLength)." + } +} +let test = Square(sideLength: 5.2, name: "my test square") +test.area() +test.simpleDescription() +``` + +> 練習： +> 創建`NamedShape`的另一個子類`Circle`，構造器接收兩個參數，一個是半徑一個是名稱，實現`area`和`describe`方法。 + +屬性可以有 getter 和 setter 。 + +```swift +class EquilateralTriangle: NamedShape { + var sideLength: Double = 0.0 + + init(sideLength: Double, name: String) { + self.sideLength = sideLength + super.init(name: name) + numberOfSides = 3 + } + + var perimeter: Double { + get { + return 3.0 * sideLength + } + set { + sideLength = newValue / 3.0 + } + } + + override func simpleDescription() -> String { + return "An equilateral triagle with sides of length \(sideLength)." + } +} +var triangle = EquilateralTriangle(sideLength: 3.1, name: "a triangle") +triangle.perimeter +triangle.perimeter = 9.9 +triangle.sideLength +``` + +在`perimeter`的 setter 中，新值的名字是`newValue`。你可以在`set`之後顯式的設置一個名字。 + +注意`EquilateralTriangle`類的構造器執行了三步： + +1. 設置子類聲明的屬性值 +2. 調用父類的構造器 +3. 改變父類定義的屬性值。其他的工作比如調用方法、getters和setters也可以在這個階段完成。 + +如果你不需要計算屬性，但是仍然需要在設置一個新值之前或者之後運行代碼，使用`willSet`和`didSet`。 + +比如，下面的類確保三角形的邊長總是和正方形的邊長相同。 + +```swift +class TriangleAndSquare { + var triangle: EquilateralTriangle { + willSet { + square.sideLength = newValue.sideLength + } + } + var square: Square { + willSet { + triangle.sideLength = newValue.sideLength + } + } + init(size: Double, name: String) { + square = Square(sideLength: size, name: name) + triangle = EquilateralTriangle(sideLength: size, name: name) + } +} +var triangleAndSquare = TriangleAndSquare(size: 10, name: "another test shape") +triangleAndSquare.square.sideLength +triangleAndSquare.triangle.sideLength +triangleAndSquare.square = Square(sideLength: 50, name: "larger square") +triangleAndSquare.triangle.sideLength +``` + +類中的方法和一般的函數有一個重要的區別，函數的參數名只在函數內部使用，但是方法的參數名需要在調用的時候顯式說明（除了第一個參數）。默認情況下，方法的參數名和它在方法內部的名字一樣，不過你也可以定義第二個名字，這個名字被用在方法內部。 + +```swift +class Counter { + var count: Int = 0 + func incrementBy(amount: Int, numberOfTimes times: Int) { + count += amount * times + } +} +var counter = Counter() +counter.incrementBy(2, numberOfTimes: 7) +``` + +處理變量的可選值時，你可以在操作（比如方法、屬性和子腳本）之前加`?`。如果`?`之前的值是`nil`，`?`後面的東西都會被忽略，並且整個表達式返回`nil`。否則，`?`之後的東西都會被運行。在這兩種情況下，整個表達式的值也是一個可選值。 + +```swift +let optionalSquare: Square? = Square(sideLength: 2.5, name: "optional square") +let sideLength = optionalSquare?.sideLength +``` + + +## 枚舉和結構體 + +使用`enum`來創建一個枚舉。就像類和其他所有命名類型一樣，枚舉可以包含方法。 + +```swift +enum Rank: Int { + case Ace = 1 + case Two, Three, Four, Five, Six, Seven, Eight, Nine, Ten + case Jack, Queen, King + func simpleDescription() -> String { + switch self { + case .Ace: + return "ace" + case .Jack: + return "jack" + case .Queen: + return "queen" + case .King: + return "king" + default: + return String(self.toRaw()) + } + } +} +let ace = Rank.Ace +let aceRawValue = ace.toRaw() +``` + +> 練習： +> 寫一個函數，通過比較它們的原始值來比較兩個`Rank`值。 + +在上面的例子中，枚舉原始值的類型是`Int`，所以你只需要設置第一個原始值。剩下的原始值會按照順序賦值。你也可以使用字符串或者浮點數作為枚舉的原始值。 + +使用`toRaw`和`fromRaw`函數來在原始值和枚舉值之間進行轉換。 + +```swift +if let convertedRank = Rank.fromRaw(3) { + let threeDescription = convertedRank.simpleDescription() +} +``` + +枚舉的成員值是實際值，並不是原始值的另一種表達方法。實際上，如果原始值沒有意義，你不需要設置。 + +```swift +enum Suit { + case Spades, Hearts, Diamonds, Clubs + func simpleDescription() -> String { + switch self { + case .Spades: + return "spades" + case .Hearts: + return "hearts" + case .Diamonds: + return "diamonds" + case .Clubs: + return "clubs" + } + } + +} +let hearts = Suit.Hearts +let heartsDescription = hearts.simpleDescription() +``` + +> 練習： +> 給`Suit`添加一個`color`方法，對`spades`和`clubs`返回「black」，對`hearts`和`diamonds`返回「red」。 + +注意，有兩種方式可以引用`Hearts`成員：給`hearts`常量賦值時，枚舉成員`Suit.Hearts`需要用全名來引用，因為常量沒有顯式指定類型。在`switch`裡，枚舉成員使用縮寫`.Hearts`來引用，因為`self`的值已經知道是一個`suit`。已知變量類型的情況下你可以使用縮寫。 + +使用`struct`來創建一個結構體。結構體和類有很多相同的地方，比如方法和構造器。它們之間最大的一個區別就是 +結構體是傳值，類是傳引用。 + +```swift +struct Card { + var rank: Rank + var suit: Suit + func simpleDescription() -> String { + return "The \(rank.simpleDescription()) of \ + (suit.simpleDescription())" + } +} +let threeOfSpades = Card(rank: .Three, suit: .Spades) +let threeOfSpadesDescription = threeOfSpades.simpleDescription() +``` + +> 練習： +> 給`Card`添加一個方法，創建一副完整的撲克牌並把每張牌的 rank 和 suit 對應起來。 + +一個枚舉成員的實例可以有實例值。相同枚舉成員的實例可以有不同的值。創建實例的時候傳入值即可。實例值和原始值是不同的：枚舉成員的原始值對於所有實例都是相同的，而且你是在定義枚舉的時候設置原始值。 + +例如，考慮從服務器獲取日出和日落的時間。服務器會返回正常結果或者錯誤信息。 + +```swift +enum ServerResponse { + case Result(String, String) + case Error(String) +} + +let success = ServerResponse.Result("6:00 am", "8:09 pm") +let failure = ServerResponse.Error("Out of cheese.") + +switch success { +case let .Result(sunrise, sunset): + let serverResponse = "Sunrise is at \(sunrise) and sunset is at \(sunset)." +case let .Error(error): + let serverResponse = "Failure... \(error)" +} +``` + +> 練習： +> 給`ServerResponse`和`switch`添加第三種情況。 + +注意如何從`ServerResponse`中提取日昇和日落時間。 + + +## 協議和擴展 + +使用`protocol`來聲明一個協議。 + +```swift +protocol ExampleProtocol { + var simpleDescription: String { get } + mutating func adjust() +} +``` + +類、枚舉和結構體都可以實現協議。 + +```swift +class SimpleClass: ExampleProtocol { + var simpleDescription: String = "A very simple class." + var anotherProperty: Int = 69105 + func adjust() { + simpleDescription += " Now 100% adjusted." + } +} +var a = SimpleClass() +a.adjust() +let aDescription = a.simpleDescription + +struct SimpleStructure: ExampleProtocol { + var simpleDescription: String = "A simple structure" + mutating func adjust() { + simpleDescription += " (adjusted)" + } +} +var b = SimpleStructure() +b.adjust() +let bDescription = b.simpleDescription +``` + +> 練習： +> 寫一個實現這個協議的枚舉。 + +注意聲明`SimpleStructure`時候`mutating`關鍵字用來標記一個會修改結構體的方法。`SimpleClass`的聲明不需要標記任何方法因為類中的方法經常會修改類。 + +使用`extension`來為現有的類型添加功能，比如新的方法和參數。你可以使用擴展來改造定義在別處，甚至是從外部庫或者框架引入的一個類型，使得這個類型遵循某個協議。 + +```swift +extension Int: ExampleProtocol { + var simpleDescription: String { + return "The number \(self)" + } + mutating func adjust() { + self += 42 + } +} +7.simpleDescription +``` + +> 練習： +> 給`Double`類型寫一個擴展，添加`absoluteValue`功能。 + +你可以像使用其他命名類型一樣使用協議名——例如，創建一個有不同類型但是都實現一個協議的對象集合。當你處理類型是協議的值時，協議外定義的方法不可用。 + +```swift +let protocolValue: ExampleProtocol = a +protocolValue.simpleDescription +// protocolValue.anotherProperty // Uncomment to see the error +``` + +即使`protocolValue`變量運行時的類型是`simpleClass`，編譯器會把它的類型當做`ExampleProtocol`。這表示你不能調用類在它實現的協議之外實現的方法或者屬性。 + + +## 泛型 + +在尖括號裡寫一個名字來創建一個泛型函數或者類型。 + +```swift +func repeat(item: ItemType, times: Int) -> ItemType[] { + var result = ItemType[]() + for i in 0..times { + result += item + } + return result +} +repeat("knock", 4) +``` + +你也可以創建泛型類、枚舉和結構體。 + +```swift +// Reimplement the Swift standard library's optional type +enum OptionalValue { + case None + case Some(T) +} +var possibleInteger: OptionalValue = .None +possibleInteger = .Some(100) +``` + +在類型名後面使用`where`來指定對類型的需求，比如，限定類型實現某一個協議，限定兩個類型是相同的，或者限定某個類必須有一個特定的父類 + +```swift +func anyCommonElements (lhs: T, rhs: U) -> Bool { + for lhsItem in lhs { + for rhsItem in rhs { + if lhsItem == rhsItem { + return true + } + } + } + return false +} +anyCommonElements([1, 2, 3], [3]) +``` + +> 練習： +> 修改`anyCommonElements`函數來創建一個函數，返回一個數組，內容是兩個序列的共有元素。 + +簡單起見，你可以忽略`where`，只在冒號後面寫協議或者類名。` `和``是等價的。 diff --git a/source-tw/chapter1/GuidedTour.playground.zip b/source-tw/chapter1/GuidedTour.playground.zip new file mode 100644 index 0000000000000000000000000000000000000000..13e2c05ec149ec1f9bffac9ae16eccd626e106ea GIT binary patch literal 109631 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 L-!tI%v9SIRk6VFb literal 0 HcmV?d00001 diff --git a/source-tw/chapter1/chapter1.md b/source-tw/chapter1/chapter1.md new file mode 100644 index 00000000..269d5fbb --- /dev/null +++ b/source-tw/chapter1/chapter1.md @@ -0,0 +1,4 @@ +# 歡迎使用 Swift + +在本章中您將瞭解 Swift 的特性和開發歷史，並對 Swift 有一個初步的瞭解。 + diff --git a/source-tw/chapter2/01_The_Basics.md b/source-tw/chapter2/01_The_Basics.md new file mode 100644 index 00000000..4974c382 --- /dev/null +++ b/source-tw/chapter2/01_The_Basics.md @@ -0,0 +1,696 @@ +> 翻譯：[numbbbbb](https://github.com/numbbbbb), [lyuka](https://github.com/lyuka), [JaySurplus](https://github.com/JaySurplus) +> 校對：[lslxdx](https://github.com/lslxdx) + +# 基礎部分 +----------------- + +本頁包含內容： + +- [常量和變量](#constants_and_variables) +- [註釋](#comments) +- [分號](#semicolons) +- [整數](#integers) +- [浮點數](#floating-point_numbers) +- [類型安全和類型推斷](#type_safety_and_type_inference) +- [數值型字面量](#numeric_literals) +- [數值型類型轉換](#numeric_type_conversion) +- [類型別名](#type_aliases) +- [布爾值](#booleans) +- [元組](#tuples) +- [可選](#optionals) +- [斷言](#assertions) + +Swift 是 iOS 和 OS X 應用開發的一門新語言。然而，如果你有 C 或者 Objective-C 開發經驗的話，你會發現 Swift 的很多內容都是你熟悉的。 + +Swift 的類型是在 C 和 Objective-C 的基礎上提出的，`Int`是整型；`Double`和`Float`是浮點型；`Bool`是布爾型；`String`是字符串。Swift 還有兩個有用的集合類型，`Array`和`Dictionary`，請參考[集合類型](04_Collection_Types.html)。 + +就像 C 語言一樣，Swift 使用變量來進行存儲並通過變量名來關聯值。在 Swift 中，值不可變的變量有著廣泛的應用，它們就是常量，而且比 C 語言的常量更強大。在 Swift 中，如果你要處理的值不需要改變，那使用常量可以讓你的代碼更加安全並且更好地表達你的意圖。 + +除了我們熟悉的類型，Swift 還增加了 Objective-C 中沒有的類型比如元組（Tuple）。元組可以讓你創建或者傳遞一組數據，比如作為函數的返回值時，你可以用一個元組可以返回多個值。 + +Swift 還增加了可選（Optional）類型，用於處理值缺失的情況。可選表示「那兒有一個值，並且它等於 x 」或者「那兒沒有值」。可選有點像在 Objective-C 中使用`nil`，但是它可以用在任何類型上，不僅僅是類。可選類型比 Objective-C 中的`nil`指針更加安全也更具表現力，它是 Swift 許多強大特性的重要組成部分。 + +Swift 是一個類型安全的語言，可選就是一個很好的例子。Swift 可以讓你清楚地知道值的類型。如果你的代碼期望得到一個`String`，類型安全會阻止你不小心傳入一個`Int`。你可以在開發階段盡早發現並修正錯誤。 + + +## 常量和變量 + +常量和變量把一個名字（比如`maximumNumberOfLoginAttempts`或者`welcomeMessage`）和一個指定類型的值（比如數字`10`或者字符串`"Hello"`）關聯起來。常量的值一旦設定就不能改變，而變量的值可以隨意更改。 + +### 聲明常量和變量 + +常量和變量必須在使用前聲明，用`let`來聲明常量，用`var`來聲明變量。下面的例子展示了如何用常量和變量來記錄用戶嘗試登錄的次數： + +```swift +let maximumNumberOfLoginAttempts = 10 +var currentLoginAttempt = 0 +``` + +這兩行代碼可以被理解為： + +「聲明一個名字是`maximumNumberOfLoginAttempts`的新常量，並給它一個值`10`。然後，聲明一個名字是`currentLoginAttempt`的變量並將它的值初始化為`0`.」 + +在這個例子中，允許的最大嘗試登錄次數被聲明為一個常量，因為這個值不會改變。當前嘗試登錄次數被聲明為一個變量，因為每次嘗試登錄失敗的時候都需要增加這個值。 + +你可以在一行中聲明多個常量或者多個變量，用逗號隔開： + +```swift +var x = 0.0, y = 0.0, z = 0.0 +``` + +>注意： +如果你的代碼中有不需要改變的值，請使用`let`關鍵字將它聲明為常量。只將需要改變的值聲明為變量。 + +### 類型標注 + +當你聲明常量或者變量的時候可以加上_類型標注（type annotation）_，說明常量或者變量中要存儲的值的類型。如果要添加類型標注，需要在常量或者變量名後面加上一個冒號和空格，然後加上類型名稱。 + +這個例子給`welcomeMessage`變量添加了類型標注，表示這個變量可以存儲`String`類型的值： + +```swift +var welcomeMessage: String +``` + +聲明中的冒號代表著「是...類型」，所以這行代碼可以被理解為： + +「聲明一個類型為`String`，名字為`welcomeMessage`的變量。」 + +「類型為`String`」的意思是「可以存儲任意`String`類型的值。」 + +`welcomeMessage`變量現在可以被設置成任意字符串： + +```swift +welcomeMessage = "Hello" +``` + +> 注意： +一般來說你很少需要寫類型標注。如果你在聲明常量或者變量的時候賦了一個初始值，Swift可以推斷出這個常量或者變量的類型，請參考[類型安全和類型推斷](#type_safety_and_type_inference)。在上面的例子中，沒有給`welcomeMessage`賦初始值，所以變量`welcomeMessage`的類型是通過一個類型標注指定的，而不是通過初始值推斷的。 + +### 常量和變量的命名 + +你可以用任何你喜歡的字符作為常量和變量名，包括 Unicode 字符： + +```swift +let π = 3.14159 +let 你好 = "你好世界" +let □氟□= "dogcow" +``` + +常量與變量名不能包含數學符號，箭頭，保留的（或者非法的）Unicode 碼位，連線與製表符。也不能以數字開頭，但是可以在常量與變量名的其他地方包含數字。 + +一旦你將常量或者變量聲明為確定的類型，你就不能使用相同的名字再次進行聲明，或者改變其存儲的值的類型。同時，你也不能將常量與變量進行互轉。 + +> 注意： +如果你需要使用與Swift保留關鍵字相同的名稱作為常量或者變量名，你可以使用反引號（`）將關鍵字包圍的方式將其作為名字使用。無論如何，你應當避免使用關鍵字作為常量或變量名，除非你別無選擇。 + +你可以更改現有的變量值為其他同類型的值，在下面的例子中，`friendlyWelcome`的值從`"Hello!"`改為了`"Bonjour!"`: + +```swift +var friendlyWelcome = "Hello!" +friendlyWelcome = "Bonjour!" +// friendlyWelcome 現在是 "Bonjour!" +``` + +與變量不同，常量的值一旦被確定就不能更改了。嘗試這樣做會導致編譯時報錯： + +```swift +let languageName = "Swift" +languageName = "Swift++" +// 這會報編譯時錯誤 - languageName 不可改變 +``` + +### 輸出常量和變量 + +你可以用`println`函數來輸出當前常量或變量的值: + +```swift +println(friendlyWelcome) +// 輸出 "Bonjour!" +``` + +`println`是一個用來輸出的全局函數，輸出的內容會在最後換行。如果你用 Xcode，`println`將會輸出內容到「console」面板上。(另一種函數叫`print`，唯一區別是在輸出內容最後不會換行。) + +`println`函數輸出傳入的`String`值： + +```swift +println("This is a string") +// 輸出 "This is a string" +``` + +與 Cocoa 裡的`NSLog`函數類似的是，`println`函數可以輸出更複雜的信息。這些信息可以包含當前常量和變量的值。 + +Swift 用_字符串插值（string interpolation）_的方式把常量名或者變量名當做佔位符加入到長字符串中，Swift 會用當前常量或變量的值替換這些佔位符。將常量或變量名放入圓括號中，並在開括號前使用反斜槓將其轉義： + +```swift +println("The current value of friendlyWelcome is \(friendlyWelcome)") +// 輸出 "The current value of friendlyWelcome is Bonjour! +``` + +> 注意： +字符串插值所有可用的選項，請參考[字符串插值](03_Strings_and_Characters.html#string_interpolation)。 + + +## 註釋 +請將你的代碼中的非執行文本註釋成提示或者筆記以方便你將來閱讀。Swift 的編譯器將會在編譯代碼時自動忽略掉註釋部分。 + +Swift 中的註釋與C 語言的註釋非常相似。單行註釋以雙正斜槓（`//`）作為起始標記: + +```swift +// 這是一個註釋 +``` + +你也可以進行多行註釋，其起始標記為單個正斜槓後跟隨一個星號（`/*`），終止標記為一個星號後跟隨單個正斜槓（`*/`）: + +```swift +/* 這是一個, +多行註釋 */ +``` + +與 C 語言多行註釋不同，Swift 的多行註釋可以嵌套在其它的多行註釋之中。你可以先生成一個多行註釋塊，然後在這個註釋塊之中再嵌套成第二個多行註釋。終止註釋時先插入第二個註釋塊的終止標記，然後再插入第一個註釋塊的終止標記： + +```swift +/* 這是第一個多行註釋的開頭 +/* 這是第二個被嵌套的多行註釋 */ +這是第一個多行註釋的結尾 */ +``` + +通過運用嵌套多行註釋，你可以快速方便的註釋掉一大段代碼，即使這段代碼之中已經含有了多行註釋塊。 + + +## 分號 +與其他大部分編程語言不同，Swift 並不強制要求你在每條語句的結尾處使用分號（`;`），當然，你也可以按照你自己的習慣添加分號。有一種情況下必須要用分號，即你打算在同一行內寫多條獨立的語句： + +```swift +let cat = "□□ println(cat) +// 輸出 "□□ +``` + + +## 整數 + +整數就是沒有小數部分的數字，比如`42`和`-23`。整數可以是`有符號`（正、負、零）或者`無符號`（正、零）。 + +Swift 提供了8，16，32和64位的有符號和無符號整數類型。這些整數類型和 C 語言的命名方式很像，比如8位無符號整數類型是`UInt8`，32位有符號整數類型是`Int32`。就像 Swift 的其他類型一樣，整數類型採用大寫命名法。 + +### 整數範圍 + +你可以訪問不同整數類型的`min`和`max`屬性來獲取對應類型的最大值和最小值： + +```swift +let minValue = UInt8.min // minValue 為 0，是 UInt8 類型的最小值 +let maxValue = UInt8.max // maxValue 為 255，是 UInt8 類型的最大值 +``` + +### Int + +一般來說，你不需要專門指定整數的長度。Swift 提供了一個特殊的整數類型`Int`，長度與當前平台的原生字長相同： + +* 在32位平台上，`Int`和`Int32`長度相同。 +* 在64位平台上，`Int`和`Int64`長度相同。 + +除非你需要特定長度的整數，一般來說使用`Int`就夠了。這可以提高代碼一致性和可復用性。即使是在32位平台上，`Int`可以存儲的整數範圍也可以達到`-2147483648`~`2147483647`，大多數時候這已經足夠大了。 + +### UInt + +Swift 也提供了一個特殊的無符號類型`UInt`，長度與當前平台的原生字長相同： + +* 在32位平台上，`UInt`和`UInt32`長度相同。 +* 在64位平台上，`UInt`和`UInt64`長度相同。 + +> 注意： +盡量不要使用`UInt`，除非你真的需要存儲一個和當前平台原生字長相同的無符號整數。除了這種情況，最好使用`Int`，即使你要存儲的值已知是非負的。統一使用`Int`可以提高代碼的可復用性，避免不同類型數字之間的轉換，並且匹配數字的類型推斷，請參考[類型安全和類型推斷](#type_safety_and_type_inference)。 + + +## 浮點數 + +浮點數是有小數部分的數字，比如`3.14159`，`0.1`和`-273.15`。 + +浮點類型比整數類型表示的範圍更大，可以存儲比`Int`類型更大或者更小的數字。Swift 提供了兩種有符號浮點數類型： + +* `Double`表示64位浮點數。當你需要存儲很大或者很高精度的浮點數時請使用此類型。 +* `Float`表示32位浮點數。精度要求不高的話可以使用此類型。 + +> 注意： +`Double`精確度很高，至少有15位數字，而`Float`最少只有6位數字。選擇哪個類型取決於你的代碼需要處理的值的範圍。 + + +## 類型安全和類型推斷 + +Swift 是一個_類型安全（type safe）_的語言。類型安全的語言可以讓你清楚地知道代碼要處理的值的類型。如果你的代碼需要一個`String`，你絕對不可能不小心傳進去一個`Int`。 + +由於 Swift 是類型安全的，所以它會在編譯你的代碼時進行_類型檢查（type checks）_，並把不匹配的類型標記為錯誤。這可以讓你在開發的時候盡早發現並修復錯誤。 + +當你要處理不同類型的值時，類型檢查可以幫你避免錯誤。然而，這並不是說你每次聲明常量和變量的時候都需要顯式指定類型。如果你沒有顯式指定類型，Swift 會使用_類型推斷（type inference）_來選擇合適的類型。有了類型推斷，編譯器可以在編譯代碼的時候自動推斷出表達式的類型。原理很簡單，只要檢查你賦的值即可。 + +因為有類型推斷，和 C 或者 Objective-C 比起來 Swift 很少需要聲明類型。常量和變量雖然需要明確類型，但是大部分工作並不需要你自己來完成。 + +當你聲明常量或者變量並賦初值的時候類型推斷非常有用。當你在聲明常量或者變量的時候賦給它們一個_字面量（literal value 或 literal）_即可觸發類型推斷。（字面量就是會直接出現在你代碼中的值，比如`42`和`3.14159`。） + +例如，如果你給一個新常量賦值`42`並且沒有標明類型，Swift 可以推斷出常量類型是`Int`，因為你給它賦的初始值看起來像一個整數： + +```swift +let meaningOfLife = 42 +// meaningOfLife 會被推測為 Int 類型 +``` + +同理，如果你沒有給浮點字面量標明類型，Swift 會推斷你想要的是`Double`： + +```swift +let pi = 3.14159 +// pi 會被推測為 Double 類型 +``` + +當推斷浮點數的類型時，Swift 總是會選擇`Double`而不是`Float`。 + +如果表達式中同時出現了整數和浮點數，會被推斷為`Double`類型： + +```swift +let anotherPi = 3 + 0.14159 +// anotherPi 會被推測為 Double 類型 +``` + +原始值`3`沒有顯式聲明類型，而表達式中出現了一個浮點字面量，所以表達式會被推斷為`Double`類型。 + + +## 數值型字面量 + +整數字面量可以被寫作： + +* 一個十進制數，沒有前綴 +* 一個二進制數，前綴是`0b` +* 一個八進制數，前綴是`0o` +* 一個十六進制數，前綴是`0x` + +下面的所有整數字面量的十進制值都是`17`: + +```swift +let decimalInteger = 17 +let binaryInteger = 0b10001 // 二進制的17 +let octalInteger = 0o21 // 八進制的17 +let hexadecimalInteger = 0x11 // 十六進制的17 +``` + +浮點字面量可以是十進制（沒有前綴）或者是十六進制（前綴是`0x`）。小數點兩邊必須有至少一個十進制數字（或者是十六進制的數字）。浮點字面量還有一個可選的_指數（exponent）_，在十進制浮點數中通過大寫或者小寫的`e`來指定，在十六進制浮點數中通過大寫或者小寫的`p`來指定。 + +如果一個十進制數的指數為`exp`，那這個數相當於基數和10^exp的乘積： +* `1.25e2` 表示 1.25 × 10^2，等於 `125.0`。 +* `1.25e-2` 表示 1.25 × 10^-2，等於 `0.0125`。 + +如果一個十六進制數的指數為`exp`，那這個數相當於基數和2^exp的乘積： +* `0xFp2` 表示 15 × 2^2，等於 `60.0`。 +* `0xFp-2` 表示 15 × 2^-2，等於 `3.75`。 + +下面的這些浮點字面量都等於十進制的`12.1875`： + +```swift +let decimalDouble = 12.1875 +let exponentDouble = 1.21875e1 +let hexadecimalDouble = 0xC.3p0 +``` + +數值類字面量可以包括額外的格式來增強可讀性。整數和浮點數都可以添加額外的零並且包含下劃線，並不會影響字面量： + +```swift +let paddedDouble = 000123.456 +let oneMillion = 1_000_000 +let justOverOneMillion = 1_000_000.000_000_1 +``` + + +## 數值型類型轉換 + +通常來講，即使代碼中的整數常量和變量已知非負，也請使用`Int`類型。總是使用默認的整數類型可以保證你的整數常量和變量可以直接被復用並且可以匹配整數類字面量的類型推斷。 +只有在必要的時候才使用其他整數類型，比如要處理外部的長度明確的數據或者為了優化性能、內存佔用等等。使用顯式指定長度的類型可以及時發現值溢出並且可以暗示正在處理特殊數據。 + +### 整數轉換 + +不同整數類型的變量和常量可以存儲不同範圍的數字。`Int8`類型的常量或者變量可以存儲的數字範圍是`-128`~`127`，而`UInt8`類型的常量或者變量能存儲的數字範圍是`0`~`255`。如果數字超出了常量或者變量可存儲的範圍，編譯的時候會報錯： + +```swift +let cannotBeNegative: UInt8 = -1 +// UInt8 類型不能存儲負數，所以會報錯 +let tooBig: Int8 = Int8.max + 1 +// Int8 類型不能存儲超過最大值的數，所以會報錯 +``` + +由於每種整數類型都可以存儲不同範圍的值，所以你必須根據不同情況選擇性使用數值型類型轉換。這種選擇性使用的方式，可以預防隱式轉換的錯誤並讓你的代碼中的類型轉換意圖變得清晰。 + +要將一種數字類型轉換成另一種，你要用當前值來初始化一個期望類型的新數字，這個數字的類型就是你的目標類型。在下面的例子中，常量`twoThousand`是`UInt16`類型，然而常量`one`是`UInt8`類型。它們不能直接相加，因為它們類型不同。所以要調用`UInt16(one)`來創建一個新的`UInt16`數字並用`one`的值來初始化，然後使用這個新數字來計算： + +```swift +let twoThousand: UInt16 = 2_000 +let one: UInt8 = 1 +let twoThousandAndOne = twoThousand + UInt16(one) +``` + +現在兩個數字的類型都是`UInt16`，可以進行相加。目標常量`twoThousandAndOne`的類型被推斷為`UInt16`，因為它是兩個`UInt16`值的和。 + +`SomeType(ofInitialValue)`是調用 Swift 構造器並傳入一個初始值的默認方法。在語言內部，`UInt16`有一個構造器，可以接受一個`UInt8`類型的值，所以這個構造器可以用現有的`UInt8`來創建一個新的`UInt16`。注意，你並不能傳入任意類型的值，只能傳入`UInt16`內部有對應構造器的值。不過你可以擴展現有的類型來讓它可以接收其他類型的值（包括自定義類型），請參考[擴展](20_Extensions.html)。 + +### 整數和浮點數轉換 + +整數和浮點數的轉換必須顯式指定類型： + +```swift +let three = 3 +let pointOneFourOneFiveNine = 0.14159 +let pi = Double(three) + pointOneFourOneFiveNine +// pi 等於 3.14159，所以被推測為 Double 類型 +``` + +這個例子中，常量`three`的值被用來創建一個`Double`類型的值，所以加號兩邊的數類型須相同。如果不進行轉換，兩者無法相加。 + +浮點數到整數的反向轉換同樣行，整數類型可以用`Double`或者`Float`類型來初始化： + +```swift +let integerPi = Int(pi) +// integerPi 等於 3，所以被推測為 Int 類型 +``` + +當用這種方式來初始化一個新的整數值時，浮點值會被截斷。也就是說`4.75`會變成`4`，`-3.9`會變成`-3`。 + +> 注意： +結合數字類常量和變量不同於結合數字類字面量。字面量`3`可以直接和字面量`0.14159`相加，因為數字字面量本身沒有明確的類型。它們的類型只在編譯器需要求值的時候被推測。 + + +## 類型別名 + +_類型別名（type aliases）_就是給現有類型定義另一個名字。你可以使用`typealias`關鍵字來定義類型別名。 + +當你想要給現有類型起一個更有意義的名字時，類型別名非常有用。假設你正在處理特定長度的外部資源的數據： + +```swift +typealias AudioSample = UInt16 +``` + +定義了一個類型別名之後，你可以在任何使用原始名的地方使用別名： + +```swift +var maxAmplitudeFound = AudioSample.min +// maxAmplitudeFound 現在是 0 +``` + +本例中，`AudioSample`被定義為`UInt16`的一個別名。因為它是別名，`AudioSample.min`實際上是`UInt16.min`，所以會給`maxAmplitudeFound`賦一個初值`0`。 + + +## 布爾值 + +Swift 有一個基本的_布爾（Boolean）_類型，叫做`Bool`。布爾值指_邏輯上的（logical）_，因為它們只能是真或者假。Swift 有兩個布爾常量，`true`和`false`： + +```swift +let orangesAreOrange = true +let turnipsAreDelicious = false +``` + +`orangesAreOrange`和`turnipsAreDelicious`的類型會被推斷為`Bool`，因為它們的初值是布爾字面量。就像之前提到的`Int`和`Double`一樣，如果你創建變量的時候給它們賦值`true`或者`false`，那你不需要將常量或者變量聲明為`Bool`類型。初始化常量或者變量的時候如果所賦的值類型已知，就可以觸發類型推斷，這讓 Swift 代碼更加簡潔並且可讀性更高。 + +當你編寫條件語句比如`if`語句的時候，布爾值非常有用： + +```swift +if turnipsAreDelicious { + println("Mmm, tasty turnips!") +} else { + println("Eww, turnips are horrible.") +} +// 輸出 "Eww, turnips are horrible." +``` + +條件語句，例如`if`，請參考[控制流](05_Control_Flow.html)。 + +如果你在需要使用`Bool`類型的地方使用了非布爾值，Swift 的類型安全機制會報錯。下面的例子會報告一個編譯時錯誤： + +```swift +let i = 1 +if i { + // 這個例子不會通過編譯，會報錯 +} +``` + +然而，下面的例子是合法的： + +```swift +let i = 1 +if i == 1 { + // 這個例子會編譯成功 +} +``` + +`i == 1`的比較結果是`Bool`類型，所以第二個例子可以通過類型檢查。類似`i == 1`這樣的比較，請參考[基本操作符](05_Control_Flow.html)。 + +和 Swift 中的其他類型安全的例子一樣，這個方法可以避免錯誤並保證這塊代碼的意圖總是清晰的。 + + +## 元組 + +_元組（tuples）_把多個值組合成一個復合值。元組內的值可以使任意類型，並不要求是相同類型。 + +下面這個例子中，`(404, "Not Found")`是一個描述 _HTTP 狀態碼（HTTP status code）_的元組。HTTP 狀態碼是當你請求網頁的時候 web 服務器返回的一個特殊值。如果你請求的網頁不存在就會返回一個`404 Not Found`狀態碼。 + +```swift +let http404Error = (404, "Not Found") +// http404Error 的類型是 (Int, String)，值是 (404, "Not Found") +``` + +`(404, "Not Found")`元組把一個`Int`值和一個`String`值組合起來表示 HTTP 狀態碼的兩個部分：一個數字和一個人類可讀的描述。這個元組可以被描述為「一個類型為`(Int, String)`的元組」。 + +你可以把任意順序的類型組合成一個元組，這個元組可以包含所有類型。只要你想，你可以創建一個類型為`(Int, Int, Int)`或者`(String, Bool)`或者其他任何你想要的組合的元組。 + +你可以將一個元組的內容_分解（decompose）_成單獨的常量和變量，然後你就可以正常使用它們了： + +```swift +let (statusCode, statusMessage) = http404Error +println("The status code is \(statusCode)") +// 輸出 "The status code is 404" +println("The status message is \(statusMessage)") +// 輸出 "The status message is Not Found" +``` + +如果你只需要一部分元組值，分解的時候可以把要忽略的部分用下劃線（`_`）標記： + +```swift +let (justTheStatusCode, _) = http404Error +println("The status code is \(justTheStatusCode)") +// 輸出 "The status code is 404" +``` + +此外，你還可以通過下標來訪問元組中的單個元素，下標從零開始： + +```swift +println("The status code is \(http404Error.0)") +// 輸出 "The status code is 404" +println("The status message is \(http404Error.1)") +// 輸出 "The status message is Not Found" +``` + +你可以在定義元組的時候給單個元素命名： + +```swift +let http200Status = (statusCode: 200, description: "OK") +``` + +給元組中的元素命名後，你可以通過名字來獲取這些元素的值： + +```swift +println("The status code is \(http200Status.statusCode)") +// 輸出 "The status code is 200" +println("The status message is \(http200Status.description)") +// 輸出 "The status message is OK" +``` + +作為函數返回值時，元組非常有用。一個用來獲取網頁的函數可能會返回一個`(Int, String)`元組來描述是否獲取成功。和只能返回一個類型的值比較起來，一個包含兩個不同類型值的元組可以讓函數的返回信息更有用。請參考[函數參數與返回值](06_Functions.html#Function_Parameters_and_Return_Values)。 + +> 注意： +元組在臨時組織值的時候很有用，但是並不適合創建複雜的數據結構。如果你的數據結構並不是臨時使用，請使用類或者結構體而不是元組。請參考[類和結構體](09_Classes_and_Structures.html)。 + + +## 可選類型 + +使用_可選類型（optionals）_來處理值可能缺失的情況。可選類型表示： + +* _有_值，等於 x + +或者 + +* _沒有_值 + +> 注意： +C 和 Objective-C 中並沒有可選類型這個概念。最接近的是 Objective-C 中的一個特性，一個方法要不返回一個對像要不返回`nil`，`nil`表示「缺少一個合法的對象」。然而，這只對對像起作用——對於結構體，基本的 C 類型或者枚舉類型不起作用。對於這些類型，Objective-C 方法一般會返回一個特殊值（比如`NSNotFound`）來暗示值缺失。這種方法假設方法的調用者知道並記得對特殊值進行判斷。然而，Swift 的可選類型可以讓你暗示_任意類型_的值缺失，並不需要一個特殊值。 + +來看一個例子。Swift 的`String`類型有一個叫做`toInt`的方法，作用是將一個`String`值轉換成一個`Int`值。然而，並不是所有的字符串都可以轉換成一個整數。字符串`"123"`可以被轉換成數字`123`，但是字符串`"hello, world"`不行。 + +下面的例子使用`toInt`方法來嘗試將一個`String`轉換成`Int`： + +```swift +let possibleNumber = "123" +let convertedNumber = possibleNumber.toInt() +// convertedNumber 被推測為類型 "Int?"， 或者類型 "optional Int" +``` + +因為`toInt`方法可能會失敗，所以它返回一個_可選類型（optional）_`Int`，而不是一個`Int`。一個可選的`Int`被寫作`Int?`而不是`Int`。問號暗示包含的值是可選類型，也就是說可能包含`Int`值也可能不包含值。（不能包含其他任何值比如`Bool`值或者`String`值。只能是`Int`或者什麼都沒有。） + +### if 語句以及強制解析 + +你可以使用`if`語句來判斷一個可選是否包含值。如果可選類型有值，結果是`true`；如果沒有值，結果是`false`。 + +當你確定可選類型_確實_包含值之後，你可以在可選的名字後面加一個感歎號（`!`）來獲取值。這個驚歎號表示「我知道這個可選有值，請使用它。」這被稱為可選值的_強制解析（forced unwrapping）_： + +```swift +if convertedNumber { + println("\(possibleNumber) has an integer value of \(convertedNumber!)") +} else { + println("\(possibleNumber) could not be converted to an integer") +} +// 輸出 "123 has an integer value of 123" +``` + +更多關於`if`語句的內容，請參考[控制流](05_Control_Flow.html)。 + +> 注意： +使用`!`來獲取一個不存在的可選值會導致運行時錯誤。使用`!`來強制解析值之前，一定要確定可選包含一個非`nil`的值。 + + +### 可選綁定 + +使用_可選綁定（optional binding）_來判斷可選類型是否包含值，如果包含就把值賦給一個臨時常量或者變量。可選綁定可以用在`if`和`while`語句中來對可選類型的值進行判斷並把值賦給一個常量或者變量。`if`和`while`語句，請參考[控制流](05_Control_Flow.html)。 + +像下面這樣在`if`語句中寫一個可選綁定： + +```swift +if let constantName = someOptional { + statements +} +``` + +你可以像上面這樣使用可選綁定來重寫`possibleNumber`這個例子： + +```swift +if let actualNumber = possibleNumber.toInt() { + println("\(possibleNumber) has an integer value of \(actualNumber)") +} else { + println("\(possibleNumber) could not be converted to an integer") +} +// 輸出 "123 has an integer value of 123" +``` + +這段代碼可以被理解為： + +「如果`possibleNumber.toInt`返回的可選`Int`包含一個值，創建一個叫做`actualNumber`的新常量並將可選包含的值賦給它。」 + +如果轉換成功，`actualNumber`常量可以在`if`語句的第一個分支中使用。它已經被可選類型_包含的_值初始化過，所以不需要再使用`!`後綴來獲取它的值。在這個例子中，`actualNumber`只被用來輸出轉換結果。 + +你可以在可選綁定中使用常量和變量。如果你想在`if`語句的第一個分支中操作`actualNumber`的值，你可以改成`if var actualNumber`，這樣可選類型包含的值就會被賦給一個變量而非常量。 + +### nil + +你可以給可選變量賦值為`nil`來表示它沒有值： + +```swift +var serverResponseCode: Int? = 404 +// serverResponseCode 包含一個可選的 Int 值 404 +serverResponseCode = nil +// serverResponseCode 現在不包含值 +``` + +> 注意： +`nil`不能用於非可選的常量和變量。如果你的代碼中有常量或者變量需要處理值缺失的情況，請把它們聲明成對應的可選類型。 + +如果你聲明一個可選常量或者變量但是沒有賦值，它們會自動被設置為`nil`： + +```swift +var surveyAnswer: String? +// surveyAnswer 被自動設置為 nil +``` + +> 注意： +Swift 的`nil`和 Objective-C 中的`nil`並不一樣。在 Objective-C 中，`nil`是一個指向不存在對象的指針。在 Swift 中，`nil`不是指針——它是一個確定的值，用來表示值缺失。_任何_類型的可選狀態都可以被設置為`nil`，不只是對像類型。 + +### 隱式解析可選類型 + +如上所述，可選類型暗示了常量或者變量可以「沒有值」。可選可以通過`if`語句來判斷是否有值，如果有值的話可以通過可選綁定來解析值。 + +有時候在程序架構中，第一次被賦值之後，可以確定一個可選類型_總會_有值。在這種情況下，每次都要判斷和解析可選值是非常低效的，因為可以確定它總會有值。 + +這種類型的可選狀態被定義為_隱式解析可選類型（implicitly unwrapped optionals）_。把想要用作可選的類型的後面的問號（`String?`）改成感歎號（`String!`）來聲明一個隱式解析可選類型。 + +當可選類型被第一次賦值之後就可以確定之後一直有值的時候，隱式解析可選類型非常有用。隱式解析可選類型主要被用在 Swift 中類的構造過程中，請參考[類實例之間的循環強引用](16_Automatic_Reference_Counting.html#strong_reference_cycles_between_class_instances)。 + +一個隱式解析可選類型其實就是一個普通的可選類型，但是可以被當做非可選類型來使用，並不需要每次都使用解析來獲取可選值。下面的例子展示了可選類型`String`和隱式解析可選類型`String`之間的區別： + +```swift +let possibleString: String? = "An optional string." +println(possibleString!) // 需要驚歎號來獲取值 +// 輸出 "An optional string." +``` + +```swift +let assumedString: String! = "An implicitly unwrapped optional string." +println(assumedString) // 不需要感歎號 +// 輸出 "An implicitly unwrapped optional string." +``` + +你可以把隱式解析可選類型當做一個可以自動解析的可選類型。你要做的只是聲明的時候把感歎號放到類型的結尾，而不是每次取值的可選名字的結尾。 + +> 注意： +如果你在隱式解析可選類型沒有值的時候嘗試取值，會觸發運行時錯誤。和你在沒有值的普通可選類型後面加一個驚歎號一樣。 + +你仍然可以把隱式解析可選類型當做普通可選類型來判斷它是否包含值： + +```swift +if assumedString { + println(assumedString) +} +// 輸出 "An implicitly unwrapped optional string." +``` + +你也可以在可選綁定中使用隱式解析可選類型來檢查並解析它的值： + +```swift +if let definiteString = assumedString { + println(definiteString) +} +// 輸出 "An implicitly unwrapped optional string." +``` + +> 注意： +如果一個變量之後可能變成`nil`的話請不要使用隱式解析可選類型。如果你需要在變量的生命週期中判斷是否是`nil`的話，請使用普通可選類型。 + + +## 斷言 + +可選類型可以讓你判斷值是否存在，你可以在代碼中優雅地處理值缺失的情況。然而，在某些情況下，如果值缺失或者值並不滿足特定的條件，你的代碼可能並不需要繼續執行。這時，你可以在你的代碼中觸發一個_斷言（assertion）_來結束代碼運行並通過調試來找到值缺失的原因。 + +### 使用斷言進行調試 + +斷言會在運行時判斷一個邏輯條件是否為`true`。從字面意思來說，斷言「斷言」一個條件是否為真。你可以使用斷言來保證在運行其他代碼之前，某些重要的條件已經被滿足。如果條件判斷為`true`，代碼運行會繼續進行；如果條件判斷為`false`，代碼運行停止，你的應用被終止。 + +如果你的代碼在調試環境下觸發了一個斷言，比如你在 Xcode 中構建並運行一個應用，你可以清楚地看到不合法的狀態發生在哪裡並檢查斷言被觸發時你的應用的狀態。此外，斷言允許你附加一條調試信息。 + +你可以使用全局`assert`函數來寫一個斷言。向`assert`函數傳入一個結果為`true`或者`false`的表達式以及一條信息，當表達式為`false`的時候這條信息會被顯示： + +```swift +let age = -3 +assert(age >= 0, "A person's age cannot be less than zero") +// 因為 age < 0，所以斷言會觸發 +``` + +在這個例子中，只有`age >= 0`為`true`的時候代碼運行才會繼續，也就是說，當`age`的值非負的時候。如果`age`的值是負數，就像代碼中那樣，`age >= 0`為`false`，斷言被觸發，結束應用。 + +斷言信息不能使用字符串插值。斷言信息可以省略，就像這樣： + +```swift +assert(age >= 0) +``` + +### 何時使用斷言 + +當條件可能為假時使用斷言，但是最終一定要_保證_條件為真，這樣你的代碼才能繼續運行。斷言的適用情景： + +* 整數類型的下標索引被傳入一個自定義下標腳本實現，但是下標索引值可能太小或者太大。 +* 需要給函數傳入一個值，但是非法的值可能導致函數不能正常執行。 +* 一個可選值現在是`nil`，但是後面的代碼運行需要一個非`nil`值。 + +請參考[下標腳本](12_Subscripts.html)和[函數](06_Functions.html)。 + +> 注意： +斷言可能導致你的應用終止運行，所以你應當仔細設計你的代碼來讓非法條件不會出現。然而，在你的應用發佈之前，有時候非法條件可能出現，這時使用斷言可以快速發現問題。 + diff --git a/source-tw/chapter2/02_Basic_Operators.md b/source-tw/chapter2/02_Basic_Operators.md new file mode 100644 index 00000000..3732be2c --- /dev/null +++ b/source-tw/chapter2/02_Basic_Operators.md @@ -0,0 +1,457 @@ +> 翻譯：[xielingwang](https://github.com/xielingwang) +> 校對：[Evilcome](https://github.com/Evilcome) + +# 基本運算符 +----------------- + +本頁包含內容： + +- [術語](#terminology) +- [賦值運算符](#assignment_operator) +- [數值運算符](#arithmetic_operators) +- [組合賦值運算符（Compound Assignment Operators）](#compound_assignment_operators) +- [比較運算符](#comparison_operators) +- [三元條件運算符（Ternary Conditional Operator）](#ternary_conditional_operator) +- [區間運算符](#range_operators) +- [邏輯運算符](#logical_operators) + +運算符是檢查、改變、合併值的特殊符號或短語。例如，加號`+`將兩個數相加（如`let i = 1 + 2`）。複雜些的運算例如邏輯與運算符`&&`（如`if enteredDoorCode && passedRetinaScan`），或讓 i 值加1的便捷自增運算符`++i`等。 + +Swift 支持大部分標準 C 語言的運算符，且改進許多特性來減少常規編碼錯誤。如：賦值符（`=`）不返回值，以防止把想要判斷相等運算符（`==`）的地方寫成賦值符導致的錯誤。數值運算符（`+`，`-`，`*`，`/`，`%`等）會檢測並不允許值溢出，以此來避免保存變量時由於變量大於或小於其類型所能承載的範圍時導致的異常結果。當然允許你使用 Swift 的溢出運算符來實現溢出。詳情參見[溢出運算符](23_Advanced_Operators.html#overflow_operators)。 + +區別於 C 語言，在 Swift 中你可以對浮點數進行取余運算（`%`），Swift 還提供了 C 語言沒有的表達兩數之間的值的區間運算符，（`a..b`和`a...b`），這方便我們表達一個區間內的數值。 + +本章節只描述了 Swift 中的基本運算符，[高級運算符](23_Advanced_Operators.html)包含了高級運算符，及如何自定義運算符，及如何進行自定義類型的運算符重載。 + + +## 術語 + +運算符有一元、二元和三元運算符。 + +- 一元運算符對單一操作對像操作（如`-a`）。一元運算符分前置符和後置運算符，前置運算符需緊排操作對像之前（如`!b`），後置運算符需緊跟操作對像之後（如`i++`）。 +- 二元運算符操作兩個操作對像（如`2 + 3`），是中置的，因為它們出現在兩個操作對像之間。 +- 三元運算符操作三個操作對象，和 C 語言一樣，Swift 只有一個三元運算符，就是三元條件運算符（`a ? b : c`）。 + +受運算符影響的值叫操作數，在表達式`1 + 2`中，加號`+`是二元運算符，它的兩個操作數是值`1`和`2`。 + + +## 賦值運算符 + +賦值運算（`a = b`），表示用`b`的值來初始化或更新`a`的值： + +```swift +let b = 10 +var a = 5 +a = b +// a 現在等於 10 +``` + +如果賦值的右邊是一個多元組，它的元素可以馬上被分解多個變量或變量： + +```swiflt +let (x, y) = (1, 2) +// 現在 x 等於 1, y 等於 2 +``` + +與 C 語言和 Objective-C 不同，Swift 的賦值操作並不返回任何值。所以以下代碼是錯誤的： + +```swift +if x = y { + // 此句錯誤, 因為 x = y 並不返回任何值 +} +``` + +這個特性使你無法把（`==`）錯寫成（`=`），由於`if x = y`是錯誤代碼，Swift 從底層幫你避免了這些錯誤代碼。 + + +## 數值運算 + +Swift 中所有數值類型都支持了基本的四則運算： + +- 加法（`+`） +- 減法（`-`） +- 乘法（`*`） +- 除法（`/`） + +```swift +1 + 2 // 等於 3 +5 - 3 // 等於 2 +2 * 3 // 等於 6 +10.0 / 2.5 // 等於 4.0 +``` + +與 C 語言和 Objective-C 不同的是，Swift 默認不允許在數值運算中出現溢出情況。但你可以使用 Swift 的溢出運算符來達到你有目的的溢出（如`a &+ b`）。詳情參見[溢出運算符](23_Advanced_Operators.html#overflow_operators)。 + +加法運算符也可用於`String`的拼接： + +```swift +"hello, " + "world" // 等於 "hello, world" +``` + +兩個`Character`值或一個`String`和一個`Character`值，相加會生成一個新的`String`值： + +```swift +let dog: Character = "d" +let cow: Character = "c" +let dogCow = dog + cow +// 譯者注: 原來的引號內是很可愛的小狗和小牛, 但win os下不支持表情字符, 所以改成了普通字符 +// dogCow 現在是 "dc" +``` + +詳情參見[字符，字符串的拼接](03_Strings_and_Characters.html#concatenating_strings_and_characters)。 + +### 求余運算 + +求余運算（`a % b`）是計算`b`的多少倍剛剛好可以容入`a`，返回多出來的那部分（餘數）。 + +>注意： +求余運算（`%`）在其他語言也叫取模運算。然而嚴格說來，我們看該運算符對負數的操作結果，"求余"比"取模"更合適些。 + +我們來談談取余是怎麼回事，計算`9 % 4`，你先計算出`4`的多少倍會剛好可以容入`9`中： + +![Art/remainderInteger_2x.png](https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/Art/remainderInteger_2x.png "Art/remainderInteger_2x.png") + +2倍，非常好，那餘數是1（用橙色標出） + +在 Swift 中這麼來表達： + +```swift +9 % 4 // 等於 1 +``` + +為了得到`a % b`的結果，`%`計算了以下等式，並輸出`餘數`作為結果： + +*a = (b × 倍數) + 餘數* + +當`倍數`取最大值的時候，就會剛好可以容入`a`中。 + +把`9`和`4`代入等式中，我們得`1`： + +```swift +9 = (4 × 2) + 1 +``` + +同樣的方法，我來們計算 `-9 % 4`： + +```swift +-9 % 4 // 等於 -1 +``` + +把`-9`和`4`代入等式，`-2`是取到的最大整數： + +```swift +-9 = (4 × -2) + -1 +``` + +餘數是`-1`。 + +在對負數`b`求余時，`b`的符號會被忽略。這意味著 `a % b` 和 `a % -b`的結果是相同的。 + +### 浮點數求余計算 + +不同於 C 語言和 Objective-C，Swift 中是可以對浮點數進行求余的。 + +```swift +8 % 2.5 // 等於 0.5 +``` + +這個例子中，`8`除於`2.5`等於`3`余`0.5`，所以結果是一個`Double`值`0.5`。 + +![Art/remainderFloat_2x.png](https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/Art/remainderFloat_2x.png "Art/remainderFloat_2x.png") + +### 自增和自增運算 + +和 C 語言一樣，Swift 也提供了方便對變量本身加1或減1的自增（`++`）和自減（`--`）的運算符。其操作對象可以是整形和浮點型。 +□ +```swift +var i = 0 +++i // 現在 i = 1 +``` + +每調用一次`++i`，`i`的值就會加1。實際上，`++i`是`i = i + 1`的簡寫，而`--i`是`i = i - 1`的簡寫。 + +`++`和`--`既是前置又是後置運算。`++i`，`i++`，`--i`和`i--`都是有效的寫法。 + +我們需要注意的是這些運算符修改了`i`後有一個返回值。如果你只想修改`i`的值，那你就可以忽略這個返回值。但如果你想使用返回值，你就需要留意前置和後置操作的返回值是不同的。 + +- 當`++`前置的時候，先自增再返回。 + +- 當`++`後置的時候，先返回再自增。 + +例如： + +```swift +var a = 0 +let b = ++a // a 和 b 現在都是 1 +let c = a++ // a 現在 2, 但 c 是 a 自增前的值 1 +``` + +上述例子，`let b = ++a`先把`a`加1了再返回`a`的值。所以`a`和`b`都是新值`1`。 + +而`let c = a++`，是先返回了`a`的值，然後`a`才加1。所以`c`得到了`a`的舊值1，而`a`加1後變成2。 + +除非你需要使用`i++`的特性，不然推薦你使用`++i`和`--i`，因為先修改後返回這樣的行為更符合我們的邏輯。 + + +### 一元負號 + +數值的正負號可以使用前綴`-`（即一元負號）來切換： + +```swift +let three = 3 +let minusThree = -three // minusThree 等於 -3 +let plusThree = -minusThree // plusThree 等於 3, 或 "負負3" +``` + +一元負號（`-`）寫在操作數之前，中間沒有空格。 + +### 一元正號 + +一元正號（`+`）不做任何改變地返回操作數的值。 + +```swift +let minusSix = -6 +let alsoMinusSix = +minusSix // alsoMinusSix 等於 -6 +``` +雖然一元`+`做無用功，但當你在使用一元負號來表達負數時，你可以使用一元正號來表達正數，如此你的代碼會具有對稱美。 + + + +## 復合賦值（Compound Assignment Operators） + +如同強大的 C 語言，Swift 也提供把其他運算符和賦值運算（`=`）組合的復合賦值運算符，加賦運算（`+=`）是其中一個例子： + +```swift +var a = 1 +a += 2 // a 現在是 3 +``` + +表達式`a += 2`是`a = a + 2`的簡寫，一個加賦運算就把加法和賦值兩件事完成了。 + +>注意： +復合賦值運算沒有返回值，`let b = a += 2`這類代碼是錯誤。這不同於上面提到的自增和自減運算符。 + +在[表達式](../chapter3/04_Expressions.html)章節裡有復合運算符的完整列表。 +□ + +## 比較運算 + +所有標準 C 語言中的比較運算都可以在 Swift 中使用。 + +- 等於（`a == b`） +- 不等於（`a != b`） +- 大於（`a > b`） +- 小於（`a < b`） +- 大於等於（`a >= b`） +- 小於等於（`a <= b`） + +> 注意： +Swift 也提供恆等`===`和不恆等`!==`這兩個比較符來判斷兩個對象是否引用同一個對像實例。更多細節在[類與結構](09_Classes_and_Structures.html)。 + +每個比較運算都返回了一個標識表達式是否成立的布爾值： + +```swift +1 == 1 // true, 因為 1 等於 1 +2 != 1 // true, 因為 2 不等於 1 +2 > 1 // true, 因為 2 大於 1 +1 < 2 // true, 因為 1 小於2 +1 >= 1 // true, 因為 1 大於等於 1 +2 <= 1 // false, 因為 2 並不小於等於 1 +``` + +比較運算多用於條件語句，如`if`條件： + +```swift +let name = "world" +if name == "world" { + println("hello, world") +} else { + println("I'm sorry \(name), but I don't recognize you") +} +// 輸出 "hello, world", 因為 `name` 就是等於 "world" +``` + +關於`if`語句，請看[控制流](05_Control_Flow.html)。 + + +## 三元條件運算(Ternary Conditional Operator) + +三元條件運算的特殊在於它是有三個操作數的運算符，它的原型是 `問題 ? 答案1 : 答案2`。它簡潔地表達根據`問題`成立與否作出二選一的操作。如果`問題`成立，返回`答案1`的結果; 如果不成立，返回`答案2`的結果。 + +使用三元條件運算簡化了以下代碼： + +```swift +if question: { + answer1 +} else { + answer2 +} +``` + +這裡有個計算表格行高的例子。如果有表頭，那行高應比內容高度要高出50像素; 如果沒有表頭，只需高出20像素。 + +```swift +let contentHeight = 40 +let hasHeader = true +let rowHeight = contentHeight + (hasHeader ? 50 : 20) +// rowHeight 現在是 90 +``` + +這樣寫會比下面的代碼簡潔： + +```swift +let contentHeight = 40 +let hasHeader = true +var rowHeight = contentHeight +if hasHeader { + rowHeight = rowHeight + 50 +} else { + rowHeight = rowHeight + 20 +} +// rowHeight 現在是 90 +``` + +第一段代碼例子使用了三元條件運算，所以一行代碼就能讓我們得到正確答案。這比第二段代碼簡潔得多，無需將`rowHeight`定義成變量，因為它的值無需在`if`語句中改變。 + +三元條件運算提供有效率且便捷的方式來表達二選一的選擇。需要注意的事，過度使用三元條件運算就會由簡潔的代碼變成難懂的代碼。我們應避免在一個組合語句使用多個三元條件運算符。 + + +## 區間運算符 + +Swift 提供了兩個方便表達一個區間的值的運算符。 + +### 閉區間運算符 +閉區間運算符（`a...b`）定義一個包含從`a`到`b`(包括`a`和`b`)的所有值的區間。 +□ +閉區間運算符在迭代一個區間的所有值時是非常有用的，如在`for-in`循環中： + +```swift +for index in 1...5 { + println("\(index) * 5 = \(index * 5)") +} +// 1 * 5 = 5 +// 2 * 5 = 10 +// 3 * 5 = 15 +// 4 * 5 = 20 +// 5 * 5 = 25 +``` + +關於`for-in`，請看[控制流](05_Control_Flow.html)。 + +### 半閉區間 + +半閉區間（`a..b`）定義一個從`a`到`b`但不包括`b`的區間。 +之所以稱為半閉區間，是因為該區間包含第一個值而不包括最後的值。 + +半閉區間的實用性在於當你使用一個0始的列表(如數組)時，非常方便地從0數到列表的長度。 + +```swift +let names = ["Anna", "Alex", "Brian", "Jack"] +let count = names.count +for i in 0..count { + println("第 \(i + 1) 個人叫 \(names[i])") +} +// 第 1 個人叫 Anna +// 第 2 個人叫 Alex +// 第 3 個人叫 Brian +// 第 4 個人叫 Jack +``` + +數組有4個元素，但`0..count`只數到3(最後一個元素的下標)，因為它是半閉區間。關於數組，請查閱[數組](04_Collection_Types.html#arrays)。 + + +## 邏輯運算 + +邏輯運算的操作對象是邏輯布爾值。Swift 支持基於 C 語言的三個標準邏輯運算。 + +- 邏輯非（`!a`） +- 邏輯與（`a && b`） +- 邏輯或（`a || b`） + +### 邏輯非 + +邏輯非運算（`!a`）對一個布爾值取反，使得`true`變`false`，`false`變`true`。 + +它是一個前置運算符，需出現在操作數之前，且不加空格。讀作`非 a`，然後我們看以下例子： + +```swift +let allowedEntry = false +if !allowedEntry { + println("ACCESS DENIED") +} +// 輸出 "ACCESS DENIED" +``` + +`if !allowedEntry`語句可以讀作 "如果 非 alowed entry。"，接下一行代碼只有在如果 "非 allow entry" 為`true`，即`allowEntry`為`false`時被執行。 + +在示例代碼中，小心地選擇布爾常量或變量有助於代碼的可讀性，並且避免使用雙重邏輯非運算，或混亂的邏輯語句。 + +### 邏輯與 +邏輯與（`a && b`）表達了只有`a`和`b`的值都為`true`時，整個表達式的值才會是`true`。 + +只要任意一個值為`false`，整個表達式的值就為`false`。事實上，如果第一個值為`false`，那麼是不去計算第二個值的，因為它已經不可能影響整個表達式的結果了。這被稱做 "短路計算（short-circuit evaluation）"。 + +以下例子，只有兩個`Bool`值都為`true`值的時候才允許進入： + +```swift +let enteredDoorCode = true +let passedRetinaScan = false +if enteredDoorCode && passedRetinaScan { + println("Welcome!") +} else { + println("ACCESS DENIED") +} +// 輸出 "ACCESS DENIED" +``` + +### 邏輯或 +邏輯或（`a || b`）是一個由兩個連續的`|`組成的中置運算符。它表示了兩個邏輯表達式的其中一個為`true`，整個表達式就為`true`。 + +同邏輯與運算類似，邏輯或也是"短路計算"的，當左端的表達式為`true`時，將不計算右邊的表達式了，因為它不可能改變整個表達式的值了。 + +以下示例代碼中，第一個布爾值（`hasDoorKey`）為`false`，但第二個值（`knowsOverridePassword`）為`true`，所以整個表達是`true`，於是允許進入： + +```swift +let hasDoorKey = false +let knowsOverridePassword = true +if hasDoorKey || knowsOverridePassword { + println("Welcome!") +} else { + println("ACCESS DENIED") +} +// 輸出 "Welcome!" +``` + +### 組合邏輯 + +我們可以組合多個邏輯運算來表達一個復合邏輯： + +```swift +if enteredDoorCode && passedRetinaScan || hasDoorKey || knowsOverridePassword { + println("Welcome!") +} else { + println("ACCESS DENIED") +} +// 輸出 "Welcome!" +``` + +這個例子使用了含多個`&&`和`||`的復合邏輯。但無論怎樣，`&&`和`||`始終只能操作兩個值。所以這實際是三個簡單邏輯連續操作的結果。我們來解讀一下： + +如果我們輸入了正確的密碼並通過了視網膜掃瞄; 或者我們有一把有效的鑰匙; 又或者我們知道緊急情況下重置的密碼，我們就能把門打開進入。 + +前兩種情況，我們都不滿足，所以前兩個簡單邏輯的結果是`false`，但是我們是知道緊急情況下重置的密碼的，所以整個複雜表達式的值還是`true`。 + +### 使用括號來明確優先級 + +為了一個複雜表達式更容易讀懂，在合適的地方使用括號來明確優先級是很有效的，雖然它並非必要的。在上個關於門的權限的例子中，我們給第一個部分加個括號，使用它看起來邏輯更明確： + +```swift +if (enteredDoorCode && passedRetinaScan) || hasDoorKey || knowsOverridePassword { + println("Welcome!") +} else { + println("ACCESS DENIED") +} +// 輸出 "Welcome!" +``` + +這括號使得前兩個值被看成整個邏輯表達中獨立的一個部分。雖然有括號和沒括號的輸出結果是一樣的，但對於讀代碼的人來說有括號的代碼更清晰。可讀性比簡潔性更重要，請在可以讓你代碼變清晰地地方加個括號吧！ diff --git a/source-tw/chapter2/03_Strings_and_Characters.md b/source-tw/chapter2/03_Strings_and_Characters.md new file mode 100644 index 00000000..0ed55d68 --- /dev/null +++ b/source-tw/chapter2/03_Strings_and_Characters.md @@ -0,0 +1,409 @@ +> 翻譯：[wh1100717](https://github.com/wh1100717) +> 校對：[Hawstein](https://github.com/Hawstein) + +# 字符串和字符（Strings and Characters） +----------------- + +本頁包含內容： + +- [字符串字面量](#string_literals) +- [初始化空字符串](#initializing_an_empty_string) +- [字符串可變性](#string_mutability) +- [字符串是值類型](#strings_are_value_types) +- [使用字符](#working_with_characters) +- [計算字符數量](#counting_characters) +- [連接字符串和字符](#concatenating_strings_and_characters) +- [字符串插值](#string_interpolation) +- [比較字符串](#comparing_strings) +- [字符串大小寫](#uppercase_and_lowercase_strings) +- [Unicode](#unicode) + +`String`是例如「hello, world」，「海賊王」 這樣的有序的`Character`（字符）類型的值的集合，通過`String`類型來表示。 + +Swift 的`String`和`Character`類型提供了一個快速的，兼容 Unicode 的方式來處理代碼中的文本信息。 +創建和操作字符串的語法與 C 語言中字符串操作相似，輕量並且易讀。 +字符串連接操作只需要簡單地通過`+`號將兩個字符串相連即可。 +與 Swift 中其他值一樣，能否更改字符串的值，取決於其被定義為常量還是變量。 + +儘管語法簡易，但`String`類型是一種快速、現代化的字符串實現。 +每一個字符串都是由獨立編碼的 Unicode 字符組成，並提供了以不同 Unicode 表示（representations）來訪問這些字符的支持。 + +Swift 可以在常量、變量、字面量和表達式中進行字符串插值操作，可以輕鬆創建用於展示、存儲和打印的自定義字符串。 + +> 注意： +Swift 的`String`類型與 Foundation `NSString`類進行了無縫橋接。如果您利用 Cocoa 或 Cocoa Touch 中的 Foundation 框架進行工作。所有`NSString` API 都可以調用您創建的任意`String`類型的值。除此之外，還可以使用本章介紹的`String`特性。您也可以在任意要求傳入`NSString`實例作為參數的 API 中使用`String`類型的值作為替代。 +>更多關於在 Foundation 和 Cocoa 中使用`String`的信息請查看 [Using Swift with Cocoa and Objective-C](https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/BuildingCocoaApps/index.html#//apple_ref/doc/uid/TP40014216)。 + + +## 字符串字面量（String Literals） + +您可以在您的代碼中包含一段預定義的字符串值作為字符串字面量。 +字符串字面量是由雙引號 ("") 包裹著的具有固定順序的文本字符集。 + +字符串字面量可以用於為常量和變量提供初始值。 + +```swift +let someString = "Some string literal value" +``` + +> 注意： +`someString`變量通過字符串字面量進行初始化，Swift 因此推斷該變量為`String`類型。 + +字符串字面量可以包含以下特殊字符： + +* 轉義字符`\0`(空字符)、`\\`(反斜線)、`\t`(水平製表符)、`\n`(換行符)、`\r`(回車符)、`\"`(雙引號)、`\'`(單引號)。 +* 單字節 Unicode 標量，寫成`\xnn`，其中`nn`為兩位十六進制數。 +* 雙字節 Unicode 標量，寫成`\unnnn`，其中`nnnn`為四位十六進制數。 +* 四字節 Unicode 標量，寫成`\Unnnnnnnn`，其中`nnnnnnnn`為八位十六進制數。 + +下面的代碼為各種特殊字符的使用示例。 +`wiseWords`常量包含了兩個轉移特殊字符 (雙括號)； +`dollarSign`、`blackHeart`和`sparklingHeart`常量演示了三種不同格式的 Unicode 標量： + +```swift +let wiseWords = "\"我是要成為海賊王的男人\" - 路飛" +// "我是要成為海賊王的男人" - 路飛 +let dollarSign = "\x24" // $, Unicode 標量 U+0024 +let blackHeart = "\u2665" // □, Unicode 標量 U+2665 +let sparklingHeart = "\U0001F496" // □欠Unicode 標量 U+1F496 +``` + + +## 初始化空字符串 (Initializing an Empty String) + +為了構造一個很長的字符串，可以創建一個空字符串作為初始值。 +可以將空的字符串字面量賦值給變量，也可以初始化一個新的`String`實例： + +```swift +var emptyString = "" // 空字符串字面量 +var anotherEmptyString = String() // 初始化 String 實例 +// 兩個字符串均為空並等價。 +``` + +您可以通過檢查其`Boolean`類型的`isEmpty`屬性來判斷該字符串是否為空： + +```swift +if emptyString.isEmpty { + println("什麼都沒有") +} +// 打印輸出："什麼都沒有" +``` + + +## 字符串可變性 (String Mutability) + +您可以通過將一個特定字符串分配給一個變量來對其進行修改，或者分配給一個常量來保證其不會被修改： + +```swift +var variableString = "Horse" +variableString += " and carriage" +// variableString 現在為 "Horse and carriage" +let constantString = "Highlander" +constantString += " and another Highlander" +// 這會報告一個編譯錯誤 (compile-time error) - 常量不可以被修改。 +``` + +> 注意： +在 Objective-C 和 Cocoa 中，您通過選擇兩個不同的類(`NSString`和`NSMutableString`)來指定該字符串是否可以被修改，Swift 中的字符串是否可以修改僅通過定義的是變量還是常量來決定，實現了多種類型可變性操作的統一。 + + +## 字符串是值類型（Strings Are Value Types） + +Swift 的`String`類型是值類型。 +如果您創建了一個新的字符串，那麼當其進行常量、變量賦值操作或在函數/方法中傳遞時，會進行值拷貝。 +任何情況下，都會對已有字符串值創建新副本，並對該新副本進行傳遞或賦值操作。 +值類型在 [結構體和枚舉是值類型](09_Classes_and_Structures.html#structures_and_enumerations_are_value_types) 中進行了說明。 + +> 注意： +與 Cocoa 中的`NSString`不同，當您在 Cocoa 中創建了一個`NSString`實例，並將其傳遞給一個函數/方法，或者賦值給一個變量，您傳遞或賦值的是該`NSString`實例的一個引用，除非您特別要求進行值拷貝，否則字符串不會生成新的副本來進行賦值操作。 + +Swift 默認字符串拷貝的方式保證了在函數/方法中傳遞的是字符串的值。 +很明顯無論該值來自於哪裡，都是您獨自擁有的。 +您可以放心您傳遞的字符串本身不會被更改。 + +在實際編譯時，Swift 編譯器會優化字符串的使用，使實際的複製只發生在絕對必要的情況下，這意味著您將字符串作為值類型的同時可以獲得極高的性能。 + + +## 使用字符（Working with Characters） + +Swift 的`String`類型表示特定序列的`Character`（字符） 類型值的集合。 +每一個字符值代表一個 Unicode 字符。 +您可利用`for-in`循環來遍歷字符串中的每一個字符： + +```swift +for character in "Dog!□梠{ + println(character) +} +// D +// o +// g +// ! +// □捊``` + +for-in 循環在 [For Loops](05_Control_Flow.html#for_loops) 中進行了詳細描述。 + +另外，通過標明一個`Character`類型註解並通過字符字面量進行賦值，可以建立一個獨立的字符常量或變量： + +```swift +let yenSign: Character = "￥" +``` + + +## 計算字符數量 (Counting Characters) + +通過調用全局`countElements`函數，並將字符串作為參數進行傳遞，可以獲取該字符串的字符數量。 + +```swift +let unusualMenagerie = "Koala □謠Snail □□Penguin □笠Dromedary □□ +println("unusualMenagerie has \(countElements(unusualMenagerie)) characters") +// 打印輸出："unusualMenagerie has 40 characters" +``` + +> 注意： +不同的 Unicode 字符以及相同 Unicode 字符的不同表示方式可能需要不同數量的內存空間來存儲。所以 Swift 中的字符在一個字符串中並不一定佔用相同的內存空間。因此字符串的長度不得不通過迭代字符串中每一個字符的長度來進行計算。如果您正在處理一個長字符串，需要注意`countElements`函數必須遍歷字符串中的字符以精準計算字符串的長度。 +> 另外需要注意的是通過`countElements`返回的字符數量並不總是與包含相同字符的`NSString`的`length`屬性相同。`NSString`的`length`屬性是基於利用 UTF-16 表示的十六位代碼單元數字，而不是基於 Unicode 字符。為了解決這個問題，`NSString`的`length`屬性在被 Swift 的`String`訪問時會成為`utf16count`。 + + +## 連接字符串和字符 (Concatenating Strings and Characters) + +字符串和字符的值可以通過加法運算符（`+`）相加在一起並創建一個新的字符串值： + +```swift +let string1 = "hello" +let string2 = " there" +let character1: Character = "!" +let character2: Character = "?" + +let stringPlusCharacter = string1 + character1 // 等於 "hello!" +let stringPlusString = string1 + string2 // 等於 "hello there" +let characterPlusString = character1 + string1 // 等於 "!hello" +let characterPlusCharacter = character1 + character2 // 等於 "!?" +``` + +您也可以通過加法賦值運算符 (`+=`) 將一個字符串或者字符添加到一個已經存在字符串變量上： + +```swift +var instruction = "look over" +instruction += string2 +// instruction 現在等於 "look over there" + +var welcome = "good morning" +welcome += character1 +// welcome 現在等於 "good morning!" +``` + +> 注意： +您不能將一個字符串或者字符添加到一個已經存在的字符變量上，因為字符變量只能包含一個字符。 + + +## 字符串插值 (String Interpolation) + +字符串插值是一種構建新字符串的方式，可以在其中包含常量、變量、字面量和表達式。 +您插入的字符串字面量的每一項都被包裹在以反斜線為前綴的圓括號中： + +```swift +let multiplier = 3 +let message = "\(multiplier) 乘以 2.5 是 \(Double(multiplier) * 2.5)" +// message 是 "3 乘以 2.5 是 7.5" +``` + +在上面的例子中，`multiplier`作為`\(multiplier)`被插入到一個字符串字面量中。 +當創建字符串執行插值計算時此佔位符會被替換為`multiplier`實際的值。 + +`multiplier`的值也作為字符串中後面表達式的一部分。 +該表達式計算`Double(multiplier) * 2.5`的值並將結果 (7.5) 插入到字符串中。 +在這個例子中，表達式寫為`\(Double(multiplier) * 2.5)`並包含在字符串字面量中。 + +> 注意： +插值字符串中寫在括號中的表達式不能包含非轉義雙引號 (`"`) 和反斜槓 (`\`)，並且不能包含回車或換行符。 + + +## 比較字符串 (Comparing Strings) + +Swift 提供了三種方式來比較字符串的值：字符串相等、前綴相等和後綴相等。 + + +### 字符串相等 (String Equality) + +如果兩個字符串以同一順序包含完全相同的字符，則認為兩者字符串相等： + +```swift +let quotation = "我們是一樣一樣滴." +let sameQuotation = "我們是一樣一樣滴." +if quotation == sameQuotation { + println("這兩個字符串被認為是相同的") +} +// 打印輸出："這兩個字符串被認為是相同的" +``` + + +### 前綴/後綴相等 (Prefix and Suffix Equality) + +通過調用字符串的`hasPrefix`/`hasSuffix`方法來檢查字符串是否擁有特定前綴/後綴。 +兩個方法均需要以字符串作為參數傳入並傳出`Boolean`值。 +兩個方法均執行基本字符串和前綴/後綴字符串之間逐個字符的比較操作。 + +下面的例子以一個字符串數組表示莎士比亞話劇《羅密歐與朱麗葉》中前兩場的場景位置： + +```swift +let romeoAndJuliet = [ + "Act 1 Scene 1: Verona, A public place", + "Act 1 Scene 2: Capulet's mansion", + "Act 1 Scene 3: A room in Capulet's mansion", + "Act 1 Scene 4: A street outside Capulet's mansion", + "Act 1 Scene 5: The Great Hall in Capulet's mansion", + "Act 2 Scene 1: Outside Capulet's mansion", + "Act 2 Scene 2: Capulet's orchard", + "Act 2 Scene 3: Outside Friar Lawrence's cell", + "Act 2 Scene 4: A street in Verona", + "Act 2 Scene 5: Capulet's mansion", + "Act 2 Scene 6: Friar Lawrence's cell" +] +``` + +您可以利用`hasPrefix`方法來計算話劇中第一幕的場景數： + +```swift +var act1SceneCount = 0 +for scene in romeoAndJuliet { + if scene.hasPrefix("Act 1 ") { + ++act1SceneCount + } +} +println("There are \(act1SceneCount) scenes in Act 1") +// 打印輸出："There are 5 scenes in Act 1" +``` + +相似地，您可以用`hasSuffix`方法來計算發生在不同地方的場景數： + +```swift +var mansionCount = 0 +var cellCount = 0 +for scene in romeoAndJuliet { + if scene.hasSuffix("Capulet's mansion") { + ++mansionCount + } else if scene.hasSuffix("Friar Lawrence's cell") { + ++cellCount + } +} +println("\(mansionCount) mansion scenes; \(cellCount) cell scenes") +// 打印輸出："6 mansion scenes; 2 cell scenes」 +``` + + +### 大寫和小寫字符串（Uppercase and Lowercase Strings） + +您可以通過字符串的`uppercaseString`和`lowercaseString`屬性來訪問大寫/小寫版本的字符串。 + +```swift +let normal = "Could you help me, please?" +let shouty = normal.uppercaseString +// shouty 值為 "COULD YOU HELP ME, PLEASE?" +let whispered = normal.lowercaseString +// whispered 值為 "could you help me, please?" +``` + + +## Unicode + +Unicode 是一個國際標準，用於文本的編碼和表示。 +它使您可以用標準格式表示來自任意語言幾乎所有的字符，並能夠對文本文件或網頁這樣的外部資源中的字符進行讀寫操作。 + +Swift 的字符串和字符類型是完全兼容 Unicode 標準的，它支持如下所述的一系列不同的 Unicode 編碼。 + + +### Unicode 術語（Unicode Terminology） + +Unicode 中每一個字符都可以被解釋為一個或多個 unicode 標量。 +字符的 unicode 標量是一個唯一的21位數字(和名稱)，例如`U+0061`表示小寫的拉丁字母A ("a")，`U+1F425`表示小雞表情 ("□墩 + +當 Unicode 字符串被寫進文本文件或其他存儲結構當中，這些 unicode 標量將會按照 Unicode 定義的集中格式之一進行編碼。其包括`UTF-8`（以8位代碼單元進行編碼） 和`UTF-16`（以16位代碼單元進行編碼）。 + + +### 字符串的 Unicode 表示（Unicode Representations of Strings） + +Swift 提供了幾種不同的方式來訪問字符串的 Unicode 表示。 + +您可以利用`for-in`來對字符串進行遍歷，從而以 Unicode 字符的方式訪問每一個字符值。 +該過程在 [使用字符](#working_with_characters) 中進行了描述。 + +另外，能夠以其他三種 Unicode 兼容的方式訪問字符串的值： + +* UTF-8 代碼單元集合 (利用字符串的`utf8`屬性進行訪問) +* UTF-16 代碼單元集合 (利用字符串的`utf16`屬性進行訪問) +* 21位的 Unicode 標量值集合 (利用字符串的`unicodeScalars`屬性進行訪問) + +下面由`D``o``g``!`和`□栨`DOG FACE`，Unicode 標量為`U+1F436`)組成的字符串中的每一個字符代表著一種不同的表示： + +```swift +let dogString = "Dog!□皂 +``` + + +### UTF-8 + +您可以通過遍歷字符串的`utf8`屬性來訪問它的`UTF-8`表示。 +其為`UTF8View`類型的屬性，`UTF8View`是無符號8位 (`UInt8`) 值的集合，每一個`UInt8`值都是一個字符的 UTF-8 表示： + +```swift +for codeUnit in dogString.utf8 { + print("\(codeUnit) ") +} +print("\n") +// 68 111 103 33 240 159 144 182 +``` + +上面的例子中，前四個10進制代碼單元值 (68, 111, 103, 33) 代表了字符`D` `o` `g`和`!`，它們的 UTF-8 表示與 ASCII 表示相同。 +後四個代碼單元值 (240, 159, 144, 182) 是`DOG FACE`的4字節 UTF-8 表示。 + + +### UTF-16 + +您可以通過遍歷字符串的`utf16`屬性來訪問它的`UTF-16`表示。 +其為`UTF16View`類型的屬性，`UTF16View`是無符號16位 (`UInt16`) 值的集合，每一個`UInt16`都是一個字符的 UTF-16 表示： + +```swift +for codeUnit in dogString.utf16 { + print("\(codeUnit) ") +} +print("\n") +// 68 111 103 33 55357 56374 +``` + +同樣，前四個代碼單元值 (68, 111, 103, 33) 代表了字符`D` `o` `g`和`!`，它們的 UTF-16 代碼單元和 UTF-8 完全相同。 + +第五和第六個代碼單元值 (55357 和 56374) 是`DOG FACE`字符的UTF-16 表示。 +第一個值為`U+D83D`(十進制值為 55357)，第二個值為`U+DC36`(十進制值為 56374)。 + + +### Unicode 標量 (Unicode Scalars) + +您可以通過遍歷字符串的`unicodeScalars`屬性來訪問它的 Unicode 標量表示。 +其為`UnicodeScalarView`類型的屬性， `UnicodeScalarView`是`UnicodeScalar`的集合。 +`UnicodeScalar`是21位的 Unicode 代碼點。 + +每一個`UnicodeScalar`擁有一個值屬性，可以返回對應的21位數值，用`UInt32`來表示。 + +```swift +for scalar in dogString.unicodeScalars { + print("\(scalar.value) ") +} +print("\n") +// 68 111 103 33 128054 +``` + +同樣，前四個代碼單元值 (68, 111, 103, 33) 代表了字符`D` `o` `g`和`!`。 +第五位數值，128054，是一個十六進制1F436的十進製表示。 +其等同於`DOG FACE`的Unicode 標量 U+1F436。 + +作為查詢字符值屬性的一種替代方法，每個`UnicodeScalar`值也可以用來構建一個新的字符串值，比如在字符串插值中使用： + +```swift +for scalar in dogString.unicodeScalars { + println("\(scalar) ") +} +// D +// o +// g +// ! +// □捊``` diff --git a/source-tw/chapter2/04_Collection_Types.md b/source-tw/chapter2/04_Collection_Types.md new file mode 100644 index 00000000..0e9d2948 --- /dev/null +++ b/source-tw/chapter2/04_Collection_Types.md @@ -0,0 +1,428 @@ +> 翻譯：[zqp](https://github.com/zqp) +> 校對：[shinyzhu](https://github.com/shinyzhu), [stanzhai](https://github.com/stanzhai) + +# 集合類型 (Collection Types) +----------------- + +本頁包含內容： + +- [數組（Arrays）](#arrays) +- [字典（Dictionaries）](#dictionaries) +- [集合的可變性（Mutability of Collections）](#mutability_of_collections) + +Swift 語言提供經典的數組和字典兩種集合類型來存儲集合數據。數組用來按順序存儲相同類型的數據。字典雖然無序存儲相同類型數據值但是需要由獨有的標識符引用和尋址（就是鍵值對）。 + +Swift 語言裡的數組和字典中存儲的數據值類型必須明確。 這意味著我們不能把不正確的數據類型插入其中。 同時這也說明我們完全可以對獲取出的值類型非常自信。 Swift 對顯式類型集合的使用確保了我們的代碼對工作所需要的類型非常清楚，也讓我們在開發中可以早早地找到任何的類型不匹配錯誤。 + +> 注意： +Swift 的數組結構在被聲明成常量和變量或者被傳入函數與方法中時會相對於其他類型展現出不同的特性。 獲取更多信息請參見[集合的可變性](#mutability_of_collections)與[集合在賦值和複製中的行為](09_Classes_and_Structures.html#assignment_and_copy_behavior_for_collection_types)章節。 + + +## 數組 + +數組使用有序列表存儲同一類型的多個值。相同的值可以多次出現在一個數組的不同位置中。 + +Swift 數組特定於它所存儲元素的類型。這與 Objective-C 的 NSArray 和 NSMutableArray 不同，這兩個類可以存儲任意類型的對象，並且不提供所返回對象的任何特別信息。在 Swift 中，數據值在被存儲進入某個數組之前類型必須明確，方法是通過顯式的類型標注或類型推斷，而且不是必須是`class`類型。例如： 如果我們創建了一個`Int`值類型的數組，我們不能往其中插入任何不是`Int`類型的數據。 Swift 中的數組是類型安全的，並且它們中包含的類型必須明確。 + + +### 數組的簡單語法 + +寫 Swift 數組應該遵循像`Array`這樣的形式，其中`SomeType`是這個數組中唯一允許存在的數據類型。 我們也可以使用像`SomeType[]`這樣的簡單語法。 儘管兩種形式在功能上是一樣的，但是推薦較短的那種，而且在本文中都會使用這種形式來使用數組。 + + +### 數組構造語句 + +我們可以使用字面量來進行數組構造，這是一種用一個或者多個數值構造數組的簡單方法。字面量是一系列由逗號分割並由方括號包含的數值。 +`[value 1, value 2, value 3]`。 + +下面這個例子創建了一個叫做`shoppingList`並且存儲字符串的數組： + +```swift +var shoppingList: String[] = ["Eggs", "Milk"] +// shoppingList 已經被構造並且擁有兩個初始項。 +``` + +`shoppingList`變量被聲明為「字符串值類型的數組「，記作`String[]`。 因為這個數組被規定只有`String`一種數據結構，所以只有`String`類型可以在其中被存取。 在這裡，`shoppinglist`數組由兩個`String`值（`"Eggs"` 和`"Milk"`）構造，並且由字面量定義。 + +> 注意： +> `Shoppinglist`數組被聲明為變量（`var`關鍵字創建）而不是常量（`let`創建）是因為以後可能會有更多的數據項被插入其中。 + +在這個例子中，字面量僅僅包含兩個`String`值。匹配了該數組的變量聲明（只能包含`String`的數組），所以這個字面量的分配過程就是允許用兩個初始項來構造`shoppinglist`。 + +由於 Swift 的類型推斷機制，當我們用字面量構造只擁有相同類型值數組的時候，我們不必把數組的類型定義清楚。 `shoppinglist`的構造也可以這樣寫： + +```swift +var shoppingList = ["Eggs", "Milk"] +``` + +因為所有字面量中的值都是相同的類型，Swift 可以推斷出`String[]`是`shoppinglist`中變量的正確類型。 + + +### 訪問和修改數組 + +我們可以通過數組的方法和屬性來訪問和修改數組，或者下標語法。 +還可以使用數組的只讀屬性`count`來獲取數組中的數據項數量。 + +```swift +println("The shopping list contains \(shoppingList.count) items.") +// 輸出"The shopping list contains 2 items."（這個數組有2個項） +``` + +使用布爾項`isEmpty`來作為檢查`count`屬性的值是否為 0 的捷徑。 + +```swift +if shoppingList.isEmpty { + println("The shopping list is empty.") +} else { + println("The shopping list is not empty.") +} +// 打印 "The shopping list is not empty."（shoppinglist不是空的） +``` + +也可以使用`append`方法在數組後面添加新的數據項： + +```swift +shoppingList.append("Flour") +// shoppingList 現在有3個數據項，有人在攤煎餅 +``` + +除此之外，使用加法賦值運算符（`+=`）也可以直接在數組後面添加數據項： + +```swift +shoppingList += "Baking Powder" +// shoppingList 現在有四項了 +``` + +我們也可以使用加法賦值運算符（`+=`）直接添加擁有相同類型數據的數組。 + +```swift +shoppingList += ["Chocolate Spread", "Cheese", "Butter"] +// shoppingList 現在有7項了 +``` + +可以直接使用下標語法來獲取數組中的數據項，把我們需要的數據項的索引值放在直接放在數組名稱的方括號中： + +```swift +var firstItem = shoppingList[0] +// 第一項是 "Eggs" +``` + +注意第一項在數組中的索引值是`0`而不是`1`。 Swift 中的數組索引總是從零開始。 + +我們也可以用下標來改變某個已有索引值對應的數據值： + +```swift +shoppingList[0] = "Six eggs" +// 其中的第一項現在是 "Six eggs" 而不是 "Eggs" +``` + +還可以利用下標來一次改變一系列數據值，即使新數據和原有數據的數量是不一樣的。下面的例子把`"Chocolate Spread"`，`"Cheese"`，和`"Butter"`替換為`"Bananas"`和 `"Apples"`： + +```swift +shoppingList[4...6] = ["Bananas", "Apples"] +// shoppingList 現在有六項 +``` + +> 注意： +>我們不能使用下標語法在數組尾部添加新項。如果我們試著用這種方法對索引越界的數據進行檢索或者設置新值的操作，我們會引發一個運行期錯誤。我們可以使用索引值和數組的`count`屬性進行比較來在使用某個索引之前先檢驗是否有效。除了當`count`等於 0 時（說明這是個空數組），最大索引值一直是`count - 1`，因為數組都是零起索引。 + +調用數組的`insert(atIndex:)`方法來在某個具體索引值之前添加數據項： + +```swift +shoppingList.insert("Maple Syrup", atIndex: 0) +// shoppingList 現在有7項 +// "Maple Syrup" 現在是這個列表中的第一項 +``` + +這次`insert`函數調用把值為`"Maple Syrup"`的新數據項插入列表的最開始位置，並且使用`0`作為索引值。 + +類似的我們可以使用`removeAtIndex`方法來移除數組中的某一項。這個方法把數組在特定索引值中存儲的數據項移除並且返回這個被移除的數據項（我們不需要的時候就可以無視它）: + +```swift +let mapleSyrup = shoppingList.removeAtIndex(0) +// 索引值為0的數據項被移除 +// shoppingList 現在只有6項，而且不包括Maple Syrup +// mapleSyrup常量的值等於被移除數據項的值 "Maple Syrup" +``` + +數據項被移除後數組中的空出項會被自動填補，所以現在索引值為`0`的數據項的值再次等於`"Six eggs"`: + +```swift +firstItem = shoppingList[0] +// firstItem 現在等於 "Six eggs" +``` + +如果我們只想把數組中的最後一項移除，可以使用`removeLast`方法而不是`removeAtIndex`方法來避免我們需要獲取數組的`count`屬性。就像後者一樣，前者也會返回被移除的數據項： + +```swift +let apples = shoppingList.removeLast() +// 數組的最後一項被移除了 +// shoppingList現在只有5項，不包括cheese +// apples 常量的值現在等於"Apples" 字符串 +``` + + +### 數組的遍歷 + +我們可以使用`for-in`循環來遍歷所有數組中的數據項： + +```swift +for item in shoppingList { + println(item) +} +// Six eggs +// Milk +// Flour +// Baking Powder +// Bananas +``` + +如果我們同時需要每個數據項的值和索引值，可以使用全局`enumerate`函數來進行數組遍歷。`enumerate`返回一個由每一個數據項索引值和數據值組成的元組。我們可以把這個元組分解成臨時常量或者變量來進行遍歷： + +```swift +for (index, value) in enumerate(shoppingList) { + println("Item \(index + 1): \(value)") +} +// Item 1: Six eggs +// Item 2: Milk +// Item 3: Flour +// Item 4: Baking Powder +// Item 5: Bananas +``` + +更多關於`for-in`循環的介紹請參見[for 循環](05_Control_Flow.html#for_loops)。 + + +### 創建並且構造一個數組 + +我們可以使用構造語法來創建一個由特定數據類型構成的空數組： + +```swift +var someInts = Int[]() +println("someInts is of type Int[] with \(someInts.count) items。") +// 打印 "someInts is of type Int[] with 0 items。"（someInts是0數據項的Int[]數組） +``` + +注意`someInts`被設置為一個`Int[]`構造函數的輸出所以它的變量類型被定義為`Int[]`。 + +除此之外，如果代碼上下文中提供了類型信息， 例如一個函數參數或者一個已經定義好類型的常量或者變量，我們可以使用空數組語句創建一個空數組，它的寫法很簡單：`[]`（一對空方括號）： + +```swift +someInts.append(3) +// someInts 現在包含一個INT值 +someInts = [] +// someInts 現在是空數組，但是仍然是Int[]類型的。 +``` + +Swift 中的`Array`類型還提供一個可以創建特定大小並且所有數據都被默認的構造方法。我們可以把準備加入新數組的數據項數量（`count`）和適當類型的初始值（`repeatedValue`）傳入數組構造函數： + +```swift +var threeDoubles = Double[](count: 3, repeatedValue:0.0) +// threeDoubles 是一種 Double[]數組, 等於 [0.0, 0.0, 0.0] +``` + +因為類型推斷的存在，我們使用這種構造方法的時候不需要特別指定數組中存儲的數據類型，因為類型可以從默認值推斷出來： + +```swift +var anotherThreeDoubles = Array(count: 3, repeatedValue: 2.5) +// anotherThreeDoubles is inferred as Double[], and equals [2.5, 2.5, 2.5] +``` + +最後，我們可以使用加法操作符（`+`）來組合兩種已存在的相同類型數組。新數組的數據類型會被從兩個數組的數據類型中推斷出來： + +```swift +var sixDoubles = threeDoubles + anotherThreeDoubles +// sixDoubles 被推斷為 Double[], 等於 [0.0, 0.0, 0.0, 2.5, 2.5, 2.5] +``` + + +## 字典 + +字典是一種存儲多個相同類型的值的容器。每個值（value）都關聯唯一的鍵（key），鍵作為字典中的這個值數據的標識符。和數組中的數據項不同，字典中的數據項並沒有具體順序。我們在需要通過標識符（鍵）訪問數據的時候使用字典，這種方法很大程度上和我們在現實世界中使用字典查字義的方法一樣。 + +Swift 的字典使用時需要具體規定可以存儲鍵和值類型。不同於 Objective-C 的`NSDictionary`和`NSMutableDictionary` 類可以使用任何類型的對象來作鍵和值並且不提供任何關於這些對象的本質信息。在 Swift 中，在某個特定字典中可以存儲的鍵和值必須提前定義清楚，方法是通過顯性類型標注或者類型推斷。 + +Swift 的字典使用`Dictionary`定義,其中`KeyType`是字典中鍵的數據類型，`ValueType`是字典中對應於這些鍵所存儲值的數據類型。 + +`KeyType`的唯一限制就是可哈希的，這樣可以保證它是獨一無二的，所有的 Swift 基本類型（例如`String`，`Int`， `Double`和`Bool`）都是默認可哈希的，並且所有這些類型都可以在字典中當做鍵使用。未關聯值的枚舉成員（參見[枚舉](08_Enumerations.html)）也是默認可哈希的。 + + +## 字典字面量 + +我們可以使用字典字面量來構造字典，它們和我們剛才介紹過的數組字面量擁有相似語法。一個字典字面量是一個定義擁有一個或者多個鍵值對的字典集合的簡單語句。 + +一個鍵值對是一個`key`和一個`value`的結合體。在字典字面量中，每一個鍵值對的鍵和值都由冒號分割。這些鍵值對構成一個列表，其中這些鍵值對由方括號包含並且由逗號分割： + +```swift +[key 1: value 1, key 2: value 2, key 3: value 3] +``` + +下面的例子創建了一個存儲國際機場名稱的字典。在這個字典中鍵是三個字母的國際航空運輸相關代碼，值是機場名稱： + +```swift +var airports: Dictionary = ["TYO": "Tokyo", "DUB": "Dublin"] +``` + +`airports`字典被定義為一種`Dictionary`,它意味著這個字典的鍵和值都是`String`類型。 + +> 注意： +> `airports`字典被聲明為變量（用`var`關鍵字）而不是常量（`let`關鍵字）因為後來更多的機場信息會被添加到這個示例字典中。 + +`airports`字典使用字典字面量初始化，包含兩個鍵值對。第一對的鍵是`TYO`，值是`Tokyo`。第二對的鍵是`DUB`，值是`Dublin`。 + +這個字典語句包含了兩個`String: String`類型的鍵值對。它們對應`airports`變量聲明的類型（一個只有`String`鍵和`String`值的字典）所以這個字典字面量是構造兩個初始數據項的`airport`字典。 + +和數組一樣，如果我們使用字面量構造字典就不用把類型定義清楚。`airports`的也可以用這種方法簡短定義： + +```swift +var airports = ["TYO": "Tokyo", "DUB": "Dublin"] +``` + +因為這個語句中所有的鍵和值都分別是相同的數據類型，Swift 可以推斷出`Dictionary`是`airports`字典的正確類型。 + + +### 讀取和修改字典 + +我們可以通過字典的方法和屬性來讀取和修改字典，或者使用下標語法。和數組一樣，我們可以通過字典的只讀屬性`count`來獲取某個字典的數據項數量： + +```swift +println("The dictionary of airports contains \(airports.count) items.") +// 打印 "The dictionary of airports contains 2 items."（這個字典有兩個數據項） +``` + +我們也可以在字典中使用下標語法來添加新的數據項。可以使用一個合適類型的 key 作為下標索引，並且分配新的合適類型的值： + +```swift +airports["LHR"] = "London" +// airports 字典現在有三個數據項 +``` + +我們也可以使用下標語法來改變特定鍵對應的值： + +```swift +airports["LHR"] = "London Heathrow" +// "LHR"對應的值 被改為 "London Heathrow +``` + +作為另一種下標方法，字典的`updateValue(forKey:)`方法可以設置或者更新特定鍵對應的值。就像上面所示的示例，`updateValue(forKey:)`方法在這個鍵不存在對應值的時候設置值或者在存在時更新已存在的值。和上面的下標方法不一樣，這個方法返回更新值之前的原值。這樣方便我們檢查更新是否成功。 + +`updateValue(forKey:)`函數會返回包含一個字典值類型的可選值。舉例來說：對於存儲`String`值的字典，這個函數會返回一個`String?`或者「可選 `String`」類型的值。如果值存在，則這個可選值值等於被替換的值，否則將會是`nil`。 + +```swift +if let oldValue = airports.updateValue("Dublin Internation", forKey: "DUB") { + println("The old value for DUB was \(oldValue).") +} +// 輸出 "The old value for DUB was Dublin."（DUB原值是dublin） +``` + +我們也可以使用下標語法來在字典中檢索特定鍵對應的值。由於使用一個沒有值的鍵這種情況是有可能發生的，可選類型返回這個鍵存在的相關值，否則就返回`nil`： + +```swift +if let airportName = airports["DUB"] { + println("The name of the airport is \(airportName).") +} else { + println("That airport is not in the airports dictionary.") +} +// 打印 "The name of the airport is Dublin Internation."（機場的名字是都柏林國際） +``` + +我們還可以使用下標語法來通過給某個鍵的對應值賦值為`nil`來從字典裡移除一個鍵值對： + +```swift +airports["APL"] = "Apple Internation" +// "Apple Internation"不是真的 APL機場, 刪除它 +airports["APL"] = nil +// APL現在被移除了 +``` + +另外，`removeValueForKey`方法也可以用來在字典中移除鍵值對。這個方法在鍵值對存在的情況下會移除該鍵值對並且返回被移除的value或者在沒有值的情況下返回`nil`： + +```swift +if let removedValue = airports.removeValueForKey("DUB") { + println("The removed airport's name is \(removedValue).") +} else { + println("The airports dictionary does not contain a value for DUB.") +} +// prints "The removed airport's name is Dublin International." +``` + + +### 字典遍歷 + +我們可以使用`for-in`循環來遍歷某個字典中的鍵值對。每一個字典中的數據項都由`(key, value)`元組形式返回，並且我們可以使用臨時常量或者變量來分解這些元組： + +```swift +for (airportCode, airportName) in airports { + println("\(airportCode): \(airportName)") +} +// TYO: Tokyo +// LHR: London Heathrow +``` + +`for-in`循環請參見[For 循環](05_Control_Flow.html#for_loops)。 + +我們也可以通過訪問它的`keys`或者`values`屬性（都是可遍歷集合）檢索一個字典的鍵或者值： + +```swift +for airportCode in airports.keys { + println("Airport code: \(airportCode)") +} +// Airport code: TYO +// Airport code: LHR + +for airportName in airports.values { + println("Airport name: \(airportName)") +} +// Airport name: Tokyo +// Airport name: London Heathrow +``` + +如果我們只是需要使用某個字典的鍵集合或者值集合來作為某個接受`Array`實例 API 的參數，可以直接使用`keys`或者`values`屬性直接構造一個新數組： + +```swift +let airportCodes = Array(airports.keys) +// airportCodes is ["TYO", "LHR"] + +let airportNames = Array(airports.values) +// airportNames is ["Tokyo", "London Heathrow"] +``` + +> 注意： +> Swift 的字典類型是無序集合類型。其中字典鍵，值，鍵值對在遍歷的時候會重新排列，而且其中順序是不固定的。 + + +### 創建一個空字典 + +我們可以像數組一樣使用構造語法創建一個空字典： + +```swift +var namesOfIntegers = Dictionary() +// namesOfIntegers 是一個空的 Dictionary +``` + +這個例子創建了一個`Int, String`類型的空字典來儲存英語對整數的命名。它的鍵是`Int`型，值是`String`型。 + +如果上下文已經提供了信息類型，我們可以使用空字典字面量來創建一個空字典，記作`[:]`（中括號中放一個冒號）： + +```swift +namesOfIntegers[16] = "sixteen" +// namesOfIntegers 現在包含一個鍵值對 +namesOfIntegers = [:] +// namesOfIntegers 又成為了一個 Int, String類型的空字典 +``` + +> 注意： +> 在後台，Swift 的數組和字典都是由泛型集合來實現的，想瞭解更多泛型和集合信息請參見[泛型](22_Generics.html)。 + + +## 集合的可變性 + +數組和字典都是在單個集合中存儲可變值。如果我們創建一個數組或者字典並且把它分配成一個變量，這個集合將會是可變的。這意味著我們可以在創建之後添加更多或移除已存在的數據項來改變這個集合的大小。與此相反，如果我們把數組或字典分配成常量，那麼它就是不可變的，它的大小不能被改變。 + +對字典來說，不可變性也意味著我們不能替換其中任何現有鍵所對應的值。不可變字典的內容在被首次設定之後不能更改。 +不可變性對數組來說有一點不同，當然我們不能試著改變任何不可變數組的大小，但是我們可以重新設定相對現存索引所對應的值。這使得 Swift 數組在大小被固定的時候依然可以做的很棒。 + +Swift 數組的可變性行為同時影響了數組實例如何被分配和修改，想獲取更多信息，請參見[集合在賦值和複製中的行為](09_Classes_and_Structures.html#assignment_and_copy_behavior_for_collection_types)。 + +> 注意： +> 在我們不需要改變數組大小的時候創建不可變數組是很好的習慣。如此 Swift 編譯器可以優化我們創建的集合。 \ No newline at end of file diff --git a/source-tw/chapter2/05_Control_Flow.md b/source-tw/chapter2/05_Control_Flow.md new file mode 100644 index 00000000..675d1232 --- /dev/null +++ b/source-tw/chapter2/05_Control_Flow.md @@ -0,0 +1,726 @@ +> 翻譯：[vclwei](https://github.com/vclwei), [coverxit](https://github.com/coverxit), [NicePiao](https://github.com/NicePiao) +> 校對：[coverxit](https://github.com/coverxit), [stanzhai](https://github.com/stanzhai) + +# 控制流 +----------------- + +本頁包含內容： + +- [For 循環](#for_loops) +- [While 循環](#while_loops) +- [條件語句](#conditional_statement) +- [控制轉移語句（Control Transfer Statements）](#control_transfer_statements) + +Swift提供了類似 C 語言的流程控制結構，包括可以多次執行任務的`for`和`while`循環，基於特定條件選擇執行不同代碼分支的`if`和`switch`語句，還有控制流程跳轉到其他代碼的`break`和`continue`語句。 + +除了 C 語言裡面傳統的 for 條件遞增（`for-condition-increment`）循環，Swift 還增加了`for-in`循環，用來更簡單地遍歷數組（array），字典（dictionary），區間（range），字符串（string）和其他序列類型。 + +Swift 的`switch`語句比 C 語言中更加強大。在 C 語言中，如果某個 case 不小心漏寫了`break`，這個 case 就會貫穿（fallthrough）至下一個 case，Swift 無需寫`break`，所以不會發生這種貫穿（fallthrough）的情況。case 還可以匹配更多的類型模式，包括區間匹配（range matching），元組（tuple）和特定類型的描述。`switch`的 case 語句中匹配的值可以是由 case 體內部臨時的常量或者變量決定，也可以由`where`分句描述更複雜的匹配條件。 + + +## For 循環 + +`for`循環用來按照指定的次數多次執行一系列語句。Swift 提供兩種`for`循環形式： + +* `for-in`用來遍歷一個區間（range），序列（sequence），集合（collection），系列（progression）裡面所有的元素執行一系列語句。 +* for條件遞增（`for-condition-increment`）語句，用來重複執行一系列語句直到達成特定條件達成，一般通過在每次循環完成後增加計數器的值來實現。 + + +### For-In + +你可以使用`for-in`循環來遍歷一個集合裡面的所有元素，例如由數字表示的區間、數組中的元素、字符串中的字符。 + +下面的例子用來輸出乘 5 乘法表前面一部分內容： + +```swift +for index in 1...5 { + println("\(index) times 5 is \(index * 5)") +} +// 1 times 5 is 5 +// 2 times 5 is 10 +// 3 times 5 is 15 +// 4 times 5 is 20 +// 5 times 5 is 25 +``` + +例子中用來進行遍歷的元素是一組使用閉區間操作符（`...`）表示的從`1`到`5`的數字。`index`被賦值為閉區間中的第一個數字（`1`），然後循環中的語句被執行一次。在本例中，這個循環只包含一個語句，用來輸出當前`index`值所對應的乘 5 乘法表結果。該語句執行後，`index`的值被更新為閉區間中的第二個數字（`2`），之後`println`方法會再執行一次。整個過程會進行到閉區間結尾為止。 + +上面的例子中，`index`是一個每次循環遍歷開始時被自動賦值的常量。這種情況下，`index`在使用前不需要聲明，只需要將它包含在循環的聲明中，就可以對其進行隱式聲明，而無需使用`let`關鍵字聲明。 + +>注意： +`index`常量只存在於循環的生命週期裡。如果你想在循環完成後訪問`index`的值，又或者想讓`index`成為一個變量而不是常量，你必須在循環之前自己進行聲明。 + +如果你不需要知道區間內每一項的值，你可以使用下劃線（`_`）替代變量名來忽略對值的訪問： + +```swift +let base = 3 +let power = 10 +var answer = 1 +for _ in 1...power { + answer *= base +} +println("\(base) to the power of \(power) is \(answer)") +// 輸出 "3 to the power of 10 is 59049" +``` + +這個例子計算 base 這個數的 power 次冪（本例中，是`3`的`10`次冪），從`1`（`3`的`0`次冪）開始做`3`的乘法， 進行`10`次，使用`1`到`10`的閉區間循環。這個計算並不需要知道每一次循環中計數器具體的值，只需要執行了正確的循環次數即可。下劃線符號`_`（替代循環中的變量）能夠忽略具體的值，並且不提供循環遍歷時對值的訪問。 + +使用`for-in`遍歷一個數組所有元素： + +```swift +let names = ["Anna", "Alex", "Brian", "Jack"] +for name in names { + println("Hello, \(name)!") +} +// Hello, Anna! +// Hello, Alex! +// Hello, Brian! +// Hello, Jack! +``` + +你也可以通過遍歷一個字典來訪問它的鍵值對（key-value pairs）。遍歷字典時，字典的每項元素會以`(key, value)`元組的形式返回，你可以在`for-in`循環中使用顯式的常量名稱來解讀`(key, value)`元組。下面的例子中，字典的鍵（key）解讀為常量`animalName`，字典的值會被解讀為常量`legCount`： + +```swift +let numberOfLegs = ["spider": 8, "ant": 6, "cat": 4] +for (animalName, legCount) in numberOfLegs { + println("\(animalName)s have \(legCount) legs") +} +// spiders have 8 legs +// ants have 6 legs +// cats have 4 legs +``` + +字典元素的遍歷順序和插入順序可能不同，字典的內容在內部是無序的，所以遍歷元素時不能保證順序。關於數組和字典，詳情參見[集合類型](../chapter2/04_Collection_Types.html)。 + +除了數組和字典，你也可以使用`for-in`循環來遍歷字符串中的字符（`Character`）： + +```swift +for character in "Hello" { + println(character) +} +// H +// e +// l +// l +// o +``` + + +### For條件遞增（for-condition-increment） + +除了`for-in`循環，Swift 提供使用條件判斷和遞增方法的標準 C 樣式`for`循環: + +```swift +for var index = 0; index < 3; ++index { + println("index is \(index)") +} +// index is 0 +// index is 1 +// index is 2 +``` + +下面是一般情況下這種循環方式的格式： + +> for `initialization`; `condition`; `increment` { +> `statements` +> } + +和 C 語言中一樣，分號將循環的定義分為 3 個部分，不同的是，Swift 不需要使用圓括號將「initialization; condition; increment」包括起來。 + +這個循環執行流程如下： + +1. 循環首次啟動時，初始化表達式（_initialization expression_）被調用一次，用來初始化循環所需的所有常量和變量。 +2. 條件表達式（_condition expression_）被調用，如果表達式調用結果為`false`，循環結束，繼續執行`for`循環關閉大括號 +（`}`）之後的代碼。如果表達式調用結果為`true`，則會執行大括號內部的代碼（_statements_）。 +3. 執行所有語句（_statements_）之後，執行遞增表達式（_increment expression_）。通常會增加或減少計數器的值，或者根據語句（_statements_）輸出來修改某一個初始化的變量。當遞增表達式運行完成後，重複執行第 2 步，條件表達式會再次執行。 + +上述描述和循環格式等同於： + +> `initialization` +> while `condition` { +> `statements` +> `increment` +> } + +在初始化表達式中聲明的常量和變量（比如`var index = 0`）只在`for`循環的生命週期裡有效。如果想在循環結束後訪問`index`的值，你必須要在循環生命週期開始前聲明`index`。 + +```swift +var index: Int +for index = 0; index < 3; ++index { + println("index is \(index)") +} +// index is 0 +// index is 1 +// index is 2 +println("The loop statements were executed \(index) times") +// 輸出 "The loop statements were executed 3 times +``` + +注意`index`在循環結束後最終的值是`3`而不是`2`。最後一次調用遞增表達式`++index`會將`index`設置為`3`，從而導致`index < 3`條件為`false`，並終止循環。 + + +## While 循環 + +`while`循環運行一系列語句直到條件變成`false`。這類循環適合使用在第一次迭代前迭代次數未知的情況下。Swift 提供兩種`while`循環形式： + +* `while`循環，每次在循環開始時計算條件是否符合； +* `do-while`循環，每次在循環結束時計算條件是否符合。 + + +###While + +`while`循環從計算單一條件開始。如果條件為`true`，會重複運行一系列語句，直到條件變為`false`。 + +下面是一般情況下 `while` 循環格式： + +> while `condition` { +> `statements` +> } + +下面的例子來玩一個叫做_蛇和梯子（Snakes and Ladders）_的小遊戲，也叫做_滑道和梯子（Chutes and Ladders）_： + +![image](https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/Art/snakesAndLadders_2x.png) + +遊戲的規則如下： + +* 遊戲盤面包括 25 個方格，遊戲目標是達到或者超過第 25 個方格； +* 每一輪，你通過擲一個 6 邊的骰子來確定你移動方塊的步數，移動的路線由上圖中橫向的虛線所示； +* 如果在某輪結束，你移動到了梯子的底部，可以順著梯子爬上去； +* 如果在某輪結束，你移動到了蛇的頭部，你會順著蛇的身體滑下去。 + +遊戲盤面可以使用一個`Int`數組來表達。數組的長度由一個`finalSquare`常量儲存，用來初始化數組和檢測最終勝利條件。遊戲盤面由 26 個 `Int` 0 值初始化，而不是 25 個（由`0`到`25`，一共 26 個）： + +```swift +let finalSquare = 25 +var board = Int[](count: finalSquare + 1, repeatedValue: 0) +``` + +一些方塊被設置成有蛇或者梯子的指定值。梯子底部的方塊是一個正值，使你可以向上移動，蛇頭處的方塊是一個負值，會讓你向下移動： + +```swift +board[03] = +08; board[06] = +11; board[09] = +09; board[10] = +02 +board[14] = -10; board[19] = -11; board[22] = -02; board[24] = -08 +``` + +3 號方塊是梯子的底部，會讓你向上移動到 11 號方格，我們使用`board[03]`等於`+08`（來表示`11`和`3`之間的差值）。使用一元加運算符（`+i`）是為了和一元減運算符（`-i`）對稱，為了讓盤面代碼整齊，小於 10 的數字都使用 0 補齊（這些風格上的調整都不是必須的，只是為了讓代碼看起來更加整潔）。 + +玩家由左下角編號為 0 的方格開始遊戲。一般來說玩家第一次擲骰子後才會進入遊戲盤面： + +```swift +var square = 0 +var diceRoll = 0 +while square < finalSquare { + // 擲骰子 + if ++diceRoll == 7 { diceRoll = 1 } + // 根據點數移動 + square += diceRoll + if square < board.count { + // 如果玩家還在棋盤上，順著梯子爬上去或者順著蛇滑下去 + square += board[square] + } +} +println("Game over!") +``` + +本例中使用了最簡單的方法來模擬擲骰子。 `diceRoll`的值並不是一個隨機數，而是以`0`為初始值，之後每一次`while`循環，`diceRoll`的值使用前置自增操作符(`++i`)來自增 1 ，然後檢測是否超出了最大值。`++diceRoll`調用完成_後_，返回值等於`diceRoll`自增後的值。任何時候如果`diceRoll`的值等於7時，就超過了骰子的最大值，會被重置為`1`。所以`diceRoll`的取值順序會一直是`1`，`2`，`3`，`4`，`5`，`6`，`1`，`2`。 + +擲完骰子後，玩家向前移動`diceRoll`個方格，如果玩家移動超過了第 25 個方格，這個時候遊戲結束，相應地，代碼會在`square`增加`board[square]`的值向前或向後移動（遇到了梯子或者蛇）之前，檢測`square`的值是否小於`board`的`count`屬性。 + +如果沒有這個檢測（`square < board.count`），`board[square]`可能會越界訪問`board`數組，導致錯誤。例如如果`square`等於`26`， 代碼會去嘗試訪問`board[26]`，超過數組的長度。 + +當本輪`while`循環運行完畢，會再檢測循環條件是否需要再運行一次循環。如果玩家移動到或者超過第 25 個方格，循環條件結果為`false`，此時遊戲結束。 + +`while` 循環比較適合本例中的這種情況，因為在 `while` 循環開始時，我們並不知道遊戲的長度或者循環的次數，只有在達成指定條件時循環才會結束。 + + + +###Do-While + +`while`循環的另外一種形式是`do-while`，它和`while`的區別是在判斷循環條件之前，先執行一次循環的代碼塊，然後重複循環直到條件為`false`。 + +下面是一般情況下 `do-while`循環的格式： + +> do { +> `statements` +> } while `condition` + +還是蛇和梯子的遊戲，使用`do-while`循環來替代`while`循環。`finalSquare`、`board`、`square`和`diceRoll`的值初始化同`while`循環一樣： + +``` swift +let finalSquare = 25 +var board = Int[](count: finalSquare + 1, repeatedValue: 0) +board[03] = +08; board[06] = +11; board[09] = +09; board[10] = +02 +board[14] = -10; board[19] = -11; board[22] = -02; board[24] = -08 +var square = 0 +var diceRoll = 0 +``` + +`do-while`的循環版本，循環中_第一步_就需要去檢測是否在梯子或者蛇的方塊上。沒有梯子會讓玩家直接上到第 25 個方格，所以玩家不會通過梯子直接贏得遊戲。這樣在循環開始時先檢測是否踩在梯子或者蛇上是安全的。 + +遊戲開始時，玩家在第 0 個方格上，`board[0]`一直等於 0， 不會有什麼影響： + +```swift +do { + // 順著梯子爬上去或者順著蛇滑下去 + square += board[square] + // 擲骰子 + if ++diceRoll == 7 { diceRoll = 1 } + // 根據點數移動 + square += diceRoll +} while square < finalSquare +println("Game over!") +``` + +檢測完玩家是否踩在梯子或者蛇上之後，開始擲骰子，然後玩家向前移動`diceRoll`個方格，本輪循環結束。 + +循環條件（`while square < finalSquare`）和`while`方式相同，但是只會在循環結束後進行計算。在這個遊戲中，`do-while`表現得比`while`循環更好。`do-while`方式會在條件判斷`square`沒有超出後直接運行`square += board[square]`，這種方式可以去掉`while`版本中的數組越界判斷。 + + +## 條件語句 + +根據特定的條件執行特定的代碼通常是十分有用的，例如：當錯誤發生時，你可能想運行額外的代碼；或者，當輸入的值太大或太小時，向用戶顯示一條消息等。要實現這些功能，你就需要使用*條件語句*。 + +Swift 提供兩種類型的條件語句：`if`語句和`switch`語句。通常，當條件較為簡單且可能的情況很少時，使用`if`語句。而`switch`語句更適用於條件較複雜、可能情況較多且需要用到模式匹配（pattern-matching）的情境。 + + +### If + +`if`語句最簡單的形式就是只包含一個條件，當且僅當該條件為`true`時，才執行相關代碼： + +```swift +var temperatureInFahrenheit = 30 +if temperatureInFahrenheit <= 32 { + println("It's very cold. Consider wearing a scarf.") +} +// 輸出 "It's very cold. Consider wearing a scarf." +``` + +上面的例子會判斷溫度是否小於等於 32 華氏度（水的冰點）。如果是，則打印一條消息；否則，不打印任何消息，繼續執行`if`塊後面的代碼。 + +當然，`if`語句允許二選一，也就是當條件為`false`時，執行 *else 語句*： + +```swift +temperatureInFahrenheit = 40 +if temperatureInFahrenheit <= 32 { + println("It's very cold. Consider wearing a scarf.") +} else { + println("It's not that cold. Wear a t-shirt.") +} +// 輸出 "It's not that cold. Wear a t-shirt." +``` + +顯然，這兩條分支中總有一條會被執行。由於溫度已升至 40 華氏度，不算太冷，沒必要再圍圍巾——因此，`else`分支就被觸發了。 + +你可以把多個`if`語句鏈接在一起，像下面這樣： + +```swift +temperatureInFahrenheit = 90 +if temperatureInFahrenheit <= 32 { + println("It's very cold. Consider wearing a scarf.") +} else if temperatureInFahrenheit >= 86 { + println("It's really warm. Don't forget to wear sunscreen.") +} else { + println("It's not that cold. Wear a t-shirt.") +} +// 輸出 "It's really warm. Don't forget to wear sunscreen." +``` + +在上面的例子中，額外的`if`語句用於判斷是不是特別熱。而最後的`else`語句被保留了下來，用於打印既不冷也不熱時的消息。 + +實際上，最後的`else`語句是可選的： + +```swift +temperatureInFahrenheit = 72 +if temperatureInFahrenheit <= 32 { + println("It's very cold. Consider wearing a scarf.") +} else if temperatureInFahrenheit >= 86 { + println("It's really warm. Don't forget to wear sunscreen.") +} +``` + +在這個例子中，由於既不冷也不熱，所以不會觸發`if`或`else if`分支，也就不會打印任何消息。 + + +### Switch + +`switch`語句會嘗試把某個值與若干個模式（pattern）進行匹配。根據第一個匹配成功的模式，`switch`語句會執行對應的代碼。當有可能的情況較多時，通常用`switch`語句替換`if`語句。 + +`switch`語句最簡單的形式就是把某個值與一個或若干個相同類型的值作比較： + +> switch `some value to consider` { +> case `value 1`: +> `respond to value 1` +> case `value 2`, +> `value 3`: +> `respond to value 2 or 3` +> default: +> `otherwise, do something else` +> } + +`switch`語句都由*多個 case* 構成。為了匹配某些更特定的值，Swift 提供了幾種更複雜的匹配模式，這些模式將在本節的稍後部分提到。 + +每一個 case 都是代碼執行的一條分支，這與`if`語句類似。與之不同的是，`switch`語句會決定哪一條分支應該被執行。 + +`switch`語句必須是_完備的_。這就是說，每一個可能的值都必須至少有一個 case 分支與之對應。在某些不可能涵蓋所有值的情況下，你可以使用默認（`default`）分支滿足該要求，這個默認分支必須在`switch`語句的最後面。 + +下面的例子使用`switch`語句來匹配一個名為`someCharacter`的小寫字符： + +```swift +let someCharacter: Character = "e" +switch someCharacter { +case "a", "e", "i", "o", "u": + println("\(someCharacter) is a vowel") +case "b", "c", "d", "f", "g", "h", "j", "k", "l", "m", +"n", "p", "q", "r", "s", "t", "v", "w", "x", "y", "z": + println("\(someCharacter) is a consonant") +default: + println("\(someCharacter) is not a vowel or a consonant") +} +// 輸出 "e is a vowel" +``` + +在這個例子中，第一個 case 分支用於匹配五個元音，第二個 case 分支用於匹配所有的輔音。 + +由於為其它可能的字符寫 case 分支沒有實際的意義，因此在這個例子中使用了默認分支來處理剩下的既不是元音也不是輔音的字符——這就保證了`switch`語句的完備性。 + + +#### 不存在隱式的貫穿（No Implicit Fallthrough） + +與 C 語言和 Objective-C 中的`switch`語句不同，在 Swift 中，當匹配的 case 分支中的代碼執行完畢後，程序會終止`switch`語句，而不會繼續執行下一個 case 分支。這也就是說，不需要在 case 分支中顯式地使用`break`語句。這使得`switch`語句更安全、更易用，也避免了因忘記寫`break`語句而產生的錯誤。 + +> 注意： +你依然可以在 case 分支中的代碼執行完畢前跳出，詳情請參考[Switch 語句中的 break](#break_in_a_switch_statement)。 + +每一個 case 分支都*必須*包含至少一條語句。像下面這樣書寫代碼是無效的，因為第一個 case 分支是空的： + +```swift +let anotherCharacter: Character = "a" +switch anotherCharacter { +case "a": +case "A": + println("The letter A") +default: + println("Not the letter A") +} +// this will report a compile-time error +``` + +不像 C 語言裡的`switch`語句，在 Swift 中，`switch`語句不會同時匹配`"a"`和`"A"`。相反的，上面的代碼會引起編譯期錯誤：`case "a": does not contain any executable statements`——這就避免了意外地從一個 case 分支貫穿到另外一個，使得代碼更安全、也更直觀。 + +一個 case 也可以包含多個模式，用逗號把它們分開（如果太長了也可以分行寫）： + +> switch `some value to consider` { +> case `value 1`, +> `value 2`: +> `statements` +> } + +> 注意： +如果想要貫穿至特定的 case 分支中，請使用`fallthrough`語句，詳情請參考[貫穿（Fallthrough）](#fallthrough)。 + + +#### 區間匹配（Range Matching） + +case 分支的模式也可以是一個值的區間。下面的例子展示了如何使用區間匹配來輸出任意數字對應的自然語言格式： + +```swift +let count = 3_000_000_000_000 +let countedThings = "stars in the Milky Way" +var naturalCount: String +switch count { +case 0: + naturalCount = "no" +case 1...3: + naturalCount = "a few" +case 4...9: + naturalCount = "several" +case 10...99: + naturalCount = "tens of" +case 100...999: + naturalCount = "hundreds of" +case 1000...999_999: + naturalCount = "thousands of" +default: + naturalCount = "millions and millions of" +} +println("There are \(naturalCount) \(countedThings).") +// 輸出 "There are millions and millions of stars in the Milky Way." +``` + + +#### 元組（Tuple） + +你可以使用元組在同一個`switch`語句中測試多個值。元組中的元素可以是值，也可以是區間。另外，使用下劃線（`_`）來匹配所有可能的值。 + +下面的例子展示了如何使用一個`(Int, Int)`類型的元組來分類下圖中的點(x, y)： + +```swift +let somePoint = (1, 1) +switch somePoint { +case (0, 0): + println("(0, 0) is at the origin") +case (_, 0): + println("(\(somePoint.0), 0) is on the x-axis") +case (0, _): + println("(0, \(somePoint.1)) is on the y-axis") +case (-2...2, -2...2): + println("(\(somePoint.0), \(somePoint.1)) is inside the box") +default: + println("(\(somePoint.0), \(somePoint.1)) is outside of the box") +} +// 輸出 "(1, 1) is inside the box" +``` + +![image](https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/Art/coordinateGraphSimple_2x.png) + +在上面的例子中，`switch`語句會判斷某個點是否是原點(0, 0)，是否在紅色的x軸上，是否在黃色y軸上，是否在一個以原點為中心的4x4的矩形裡，或者在這個矩形外面。 + +不像 C 語言，Swift 允許多個 case 匹配同一個值。實際上，在這個例子中，點(0, 0)可以匹配所有_四個 case_。但是，如果存在多個匹配，那麼只會執行第一個被匹配到的 case 分支。考慮點(0, 0)會首先匹配`case (0, 0)`，因此剩下的能夠匹配(0, 0)的 case 分支都會被忽視掉。 + + + +#### 值綁定（Value Bindings） + +case 分支的模式允許將匹配的值綁定到一個臨時的常量或變量，這些常量或變量在該 case 分支裡就可以被引用了——這種行為被稱為*值綁定*（value binding）。 + +下面的例子展示了如何在一個`(Int, Int)`類型的元組中使用值綁定來分類下圖中的點(x, y)： + +```swift +let anotherPoint = (2, 0) +switch anotherPoint { +case (let x, 0): + println("on the x-axis with an x value of \(x)") +case (0, let y): + println("on the y-axis with a y value of \(y)") +case let (x, y): + println("somewhere else at (\(x), \(y))") +} +// 輸出 "on the x-axis with an x value of 2" +``` + +![image](https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/Art/coordinateGraphMedium_2x.png) + +在上面的例子中，`switch`語句會判斷某個點是否在紅色的x軸上，是否在黃色y軸上，或者不在坐標軸上。 + +這三個 case 都聲明了常量`x`和`y`的佔位符，用於臨時獲取元組`anotherPoint`的一個或兩個值。第一個 case ——`case (let x, 0)`將匹配一個縱坐標為`0`的點，並把這個點的橫坐標賦給臨時的常量`x`。類似的，第二個 case ——`case (0, let y)`將匹配一個橫坐標為`0`的點，並把這個點的縱坐標賦給臨時的常量`y`。 + +一旦聲明了這些臨時的常量，它們就可以在其對應的 case 分支裡引用。在這個例子中，它們用於簡化`println`的書寫。 + +請注意，這個`switch`語句不包含默認分支。這是因為最後一個 case ——`case let(x, y)`聲明了一個可以匹配餘下所有值的元組。這使得`switch`語句已經完備了，因此不需要再書寫默認分支。 + +在上面的例子中，`x`和`y`是常量，這是因為沒有必要在其對應的 case 分支中修改它們的值。然而，它們也可以是變量——程序將會創建臨時變量，並用相應的值初始化它。修改這些變量只會影響其對應的 case 分支。 + + +#### Where + +case 分支的模式可以使用`where`語句來判斷額外的條件。 + +下面的例子把下圖中的點(x, y)進行了分類： + +```swift +let yetAnotherPoint = (1, -1) +switch yetAnotherPoint { +case let (x, y) where x == y: + println("(\(x), \(y)) is on the line x == y") +case let (x, y) where x == -y: + println("(\(x), \(y)) is on the line x == -y") +case let (x, y): + println("(\(x), \(y)) is just some arbitrary point") +} +// 輸出 "(1, -1) is on the line x == -y" +``` + +![image](https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/Art/coordinateGraphComplex_2x.png) + +在上面的例子中，`switch`語句會判斷某個點是否在綠色的對角線`x == y`上，是否在紫色的對角線`x == -y`上，或者不在對角線上。 + +這三個 case 都聲明了常量`x`和`y`的佔位符，用於臨時獲取元組`yetAnotherPoint`的兩個值。這些常量被用作`where`語句的一部分，從而創建一個動態的過濾器(filter)。當且僅當`where`語句的條件為`true`時，匹配到的 case 分支才會被執行。 + +就像是值綁定中的例子，由於最後一個 case 分支匹配了餘下所有可能的值，`switch`語句就已經完備了，因此不需要再書寫默認分支。 + + +## 控制轉移語句（Control Transfer Statements） + +控制轉移語句改變你代碼的執行順序，通過它你可以實現代碼的跳轉。Swift有四種控制轉移語句。 + +- continue +- break +- fallthrough +- return + +我們將會在下面討論`continue`、`break`和`fallthrough`語句。`return`語句將會在[函數](../chapter2/06_Functions.html)章節討論。 + + +### Continue + +`continue`語句告訴一個循環體立刻停止本次循環迭代，重新開始下次循環迭代。就好像在說「本次循環迭代我已經執行完了」，但是並不會離開整個循環體。 + +>注意： +在一個for條件遞增（`for-condition-increment`）循環體中，在調用`continue`語句後，迭代增量仍然會被計算求值。循環體繼續像往常一樣工作，僅僅只是循環體中的執行代碼會被跳過。 + +下面的例子把一個小寫字符串中的元音字母和空格字符移除，生成了一個含義模糊的短句： + +```swift +let puzzleInput = "great minds think alike" +var puzzleOutput = "" +for character in puzzleInput { + switch character { + case "a", "e", "i", "o", "u", " ": + continue + default: + puzzleOutput += character + } +} +println(puzzleOutput) + // 輸出 "grtmndsthnklk" +``` + +在上面的代碼中，只要匹配到元音字母或者空格字符，就調用`continue`語句，使本次循環迭代結束，從新開始下次循環迭代。這種行為使`switch`匹配到元音字母和空格字符時不做處理，而不是讓每一個匹配到的字符都被打印。 + + +### Break + +`break`語句會立刻結束整個控制流的執行。當你想要更早的結束一個`switch`代碼塊或者一個循環體時，你都可以使用`break`語句。 + + +#### 循環語句中的 break + +當在一個循環體中使用`break`時，會立刻中斷該循環體的執行，然後跳轉到表示循環體結束的大括號(`}`)後的第一行代碼。不會再有本次循環迭代的代碼被執行，也不會再有下次的循環迭代產生。 + + +#### Switch 語句中的 break + +當在一個`switch`代碼塊中使用`break`時，會立即中斷該`switch`代碼塊的執行，並且跳轉到表示`switch`代碼塊結束的大括號(`}`)後的第一行代碼。 + +這種特性可以被用來匹配或者忽略一個或多個分支。因為 Swift 的`switch`需要包含所有的分支而且不允許有為空的分支，有時為了使你的意圖更明顯，需要特意匹配或者忽略某個分支。那麼當你想忽略某個分支時，可以在該分支內寫上`break`語句。當那個分支被匹配到時，分支內的`break`語句立即結束`switch`代碼塊。 + +>注意： +當一個`switch`分支僅僅包含註釋時，會被報編譯時錯誤。註釋不是代碼語句而且也不能讓`switch`分支達到被忽略的效果。你總是可以使用`break`來忽略某個分支。 + +下面的例子通過`switch`來判斷一個`Character`值是否代表下面四種語言之一。為了簡潔，多個值被包含在了同一個分支情況中。 + +```swift +let numberSymbol: Character = "三" // 簡體中文裡的數字 3 +var possibleIntegerValue: Int? +switch numberSymbol { +case "1", "□", "一", "□": + possibleIntegerValue = 1 +case "2", "□", "二", "□": + possibleIntegerValue = 2 +case "3", "□", "三", "□": + possibleIntegerValue = 3 +case "4", "□", "四", "□": + possibleIntegerValue = 4 +default: + break +} +if let integerValue = possibleIntegerValue { + println("The integer value of \(numberSymbol) is \(integerValue).") +} else { + println("An integer value could not be found for \(numberSymbol).") +} +// 輸出 "The integer value of 三 is 3." +``` + +這個例子檢查`numberSymbol`是否是拉丁，阿拉伯，中文或者泰語中的`1`到`4`之一。如果被匹配到，該`switch`分支語句給`Int?`類型變量`possibleIntegerValue`設置一個整數值。 + +當`switch`代碼塊執行完後，接下來的代碼通過使用可選綁定來判斷`possibleIntegerValue`是否曾經被設置過值。因為是可選類型的緣故，`possibleIntegerValue`有一個隱式的初始值`nil`，所以僅僅當`possibleIntegerValue`曾被`switch`代碼塊的前四個分支中的某個設置過一個值時，可選的綁定將會被判定為成功。 + +在上面的例子中，想要把`Character`所有的的可能性都枚舉出來是不現實的，所以使用`default`分支來包含所有上面沒有匹配到字符的情況。由於這個`default`分支不需要執行任何動作，所以它只寫了一條`break`語句。一旦落入到`default`分支中後，`break`語句就完成了該分支的所有代碼操作，代碼繼續向下，開始執行`if let`語句。 + + +### 貫穿（Fallthrough） + +Swift 中的`switch`不會從上一個 case 分支落入到下一個 case 分支中。相反，只要第一個匹配到的 case 分支完成了它需要執行的語句，整個`switch`代碼塊完成了它的執行。相比之下，C 語言要求你顯示的插入`break`語句到每個`switch`分支的末尾來阻止自動落入到下一個 case 分支中。Swift 的這種避免默認落入到下一個分支中的特性意味著它的`switch` 功能要比 C 語言的更加清晰和可預測，可以避免無意識地執行多個 case 分支從而引發的錯誤。 + +如果你確實需要 C 風格的貫穿（fallthrough）的特性，你可以在每個需要該特性的 case 分支中使用`fallthrough`關鍵字。下面的例子使用`fallthrough`來創建一個數字的描述語句。 + +```swift +let integerToDescribe = 5 +var description = "The number \(integerToDescribe) is" +switch integerToDescribe { +case 2, 3, 5, 7, 11, 13, 17, 19: + description += " a prime number, and also" + fallthrough +default: + description += " an integer." +} +println(description) +// 輸出 "The number 5 is a prime number, and also an integer." +``` + +這個例子定義了一個`String`類型的變量`description`並且給它設置了一個初始值。函數使用`switch`邏輯來判斷`integerToDescribe`變量的值。當`integerToDescribe`的值屬於列表中的質數之一時，該函數添加一段文字在`description`後，來表明這個是數字是一個質數。然後它使用`fallthrough`關鍵字來「貫穿」到`default`分支中。`default`分支添加一段額外的文字在`description`的最後，至此`switch`代碼塊執行完了。 + +如果`integerToDescribe`的值不屬於列表中的任何質數，那麼它不會匹配到第一個`switch`分支。而這裡沒有其他特別的分支情況，所以`integerToDescribe`匹配到包含所有的`default`分支中。 + +當`switch`代碼塊執行完後，使用`println`函數打印該數字的描述。在這個例子中，數字`5`被準確的識別為了一個質數。 + +>注意： +`fallthrough`關鍵字不會檢查它下一個將會落入執行的 case 中的匹配條件。`fallthrough`簡單地使代碼執行繼續連接到下一個 case 中的執行代碼，這和 C 語言標準中的`switch`語句特性是一樣的。 + + +### 帶標籤的語句（Labeled Statements） + +在 Swift 中，你可以在循環體和`switch`代碼塊中嵌套循環體和`switch`代碼塊來創造複雜的控制流結構。然而，循環體和`switch`代碼塊兩者都可以使用`break`語句來提前結束整個方法體。因此，顯示地指明`break`語句想要終止的是哪個循環體或者`switch`代碼塊，會很有用。類似地，如果你有許多嵌套的循環體，顯示指明`continue`語句想要影響哪一個循環體也會非常有用。 + +為了實現這個目的，你可以使用標籤來標記一個循環體或者`switch`代碼塊，當使用`break`或者`continue`時，帶上這個標籤，可以控制該標籤代表對象的中斷或者執行。 + +產生一個帶標籤的語句是通過在該語句的關鍵詞的同一行前面放置一個標籤，並且該標籤後面還需帶著一個冒號。下面是一個`while`循環體的語法，同樣的規則適用於所有的循環體和`switch`代碼塊。 + +> `label name`: while `condition` { +> `statements` +> } + +下面的例子是在一個帶有標籤的`while`循環體中調用`break`和`continue`語句，該循環體是前面章節中_蛇和梯子_的改編版本。這次，遊戲增加了一條額外的規則： + +- 為了獲勝，你必須_剛好_落在第 25 個方塊中。 + +如果某次擲骰子使你的移動超出第 25 個方塊，你必須重新擲骰子，直到你擲出的骰子數剛好使你能落在第 25 個方塊中。 + +遊戲的棋盤和之前一樣： + +![image](https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/Art/snakesAndLadders_2x.png) + +值`finalSquare`、`board`、`square`和`diceRoll`的初始化也和之前一樣： + +```swift +let finalSquare = 25 +var board = Int[](count: finalSquare + 1, repeatedValue: 0) +board[03] = +08; board[06] = +11; board[09] = +09; board[10] = +02 +board[14] = -10; board[19] = -11; board[22] = -02; board[24] = -08 +var square = 0 +var diceRoll = 0 +``` + +這個版本的遊戲使用`while`循環體和`switch`方法塊來實現遊戲的邏輯。`while`循環體有一個標籤名`gameLoop`，來表明它是蛇與梯子的主循環。 + +該`while`循環體的條件判斷語句是`while square !=finalSquare`，這表明你必須剛好落在方格25中。 + +```swift +gameLoop: while square != finalSquare { + if ++diceRoll == 7 { diceRoll = 1 } + switch square + diceRoll { + case finalSquare: + // 到達最後一個方塊，遊戲結束 + break gameLoop + case let newSquare where newSquare > finalSquare: + // 超出最後一個方塊，再擲一次骰子 + continue gameLoop + default: + // 本次移動有效 + square += diceRoll + square += board[square] + } +} +println("Game over!") +``` + +每次循環迭代開始時擲骰子。與之前玩家擲完骰子就立即移動不同，這裡使用了`switch`來考慮每次移動可能產生的結果，從而決定玩家本次是否能夠移動。 + +- 如果骰子數剛好使玩家移動到最終的方格裡，遊戲結束。`break gameLoop`語句跳轉控制去執行`while`循環體後的第一行代碼，遊戲結束。 +- 如果骰子數將會使玩家的移動超出最後的方格，那麼這種移動是不合法的，玩家需要重新擲骰子。`continue gameLoop`語句結束本次`while`循環的迭代，開始下一次循環迭代。 +- 在剩餘的所有情況中，骰子數產生的都是合法的移動。玩家向前移動骰子數個方格，然後遊戲邏輯再處理玩家當前是否處於蛇頭或者梯子的底部。本次循環迭代結束，控制跳轉到`while`循環體的條件判斷語句處，再決定是否能夠繼續執行下次循環迭代。 + +>注意： +如果上述的`break`語句沒有使用`gameLoop`標籤，那麼它將會中斷`switch`代碼塊而不是`while`循環體。使用`gameLoop`標籤清晰的表明了`break`想要中斷的是哪個代碼塊。 +同時請注意，當調用`continue gameLoop`去跳轉到下一次循環迭代時，這裡使用`gameLoop`標籤並不是嚴格必須的。因為在這個遊戲中，只有一個循環體，所以`continue`語句會影響到哪個循環體是沒有歧義的。然而，`continue`語句使用`gameLoop`標籤也是沒有危害的。這樣做符合標籤的使用規則，同時參照旁邊的`break gameLoop`，能夠使遊戲的邏輯更加清晰和易於理解。 diff --git a/source-tw/chapter2/06_Functions.md b/source-tw/chapter2/06_Functions.md new file mode 100644 index 00000000..6e3c5e5b --- /dev/null +++ b/source-tw/chapter2/06_Functions.md @@ -0,0 +1,573 @@ +> 翻譯：[honghaoz](https://github.com/honghaoz) +> 校對：[LunaticM](https://github.com/LunaticM) + +# 函數（Functions） +----------------- + +本頁包含內容： + +- [函數定義與調用（Defining and Calling Functions）](#Defining_and_Calling_Functions) +- [函數參數與返回值（Function Parameters and Return Values）](#Function_Parameters_and_Return_Values) +- [函數參數名稱（Function Parameter Names）](#Function_Parameter_Names) +- [函數類型（Function Types）](#Function_Types) +- [函數嵌套（Nested Functions）](#Nested_Functions) + +函數是用來完成特定任務的獨立的代碼塊。你給一個函數起一個合適的名字，用來標識函數做什麼，並且當函數需要執行的時候，這個名字會被「調用」。 + +Swift 統一的函數語法足夠靈活，可以用來表示任何函數，包括從最簡單的沒有參數名字的 C 風格函數，到複雜的帶局部和外部參數名的 Objective-C 風格函數。參數可以提供默認值，以簡化函數調用。參數也可以既當做傳入參數，也當做傳出參數，也就是說，一旦函數執行結束，傳入的參數值可以被修改。 + +在 Swift 中，每個函數都有一種類型，包括函數的參數值類型和返回值類型。你可以把函數類型當做任何其他普通變量類型一樣處理，這樣就可以更簡單地把函數當做別的函數的參數，也可以從其他函數中返回函數。函數的定義可以寫在在其他函數定義中，這樣可以在嵌套函數範圍內實現功能封裝。 + + +## 函數的定義與調用（Defining and Calling Functions） + +當你定義一個函數時，你可以定義一個或多個有名字和類型的值，作為函數的輸入（稱為參數，parameters），也可以定義某種類型的值作為函數執行結束的輸出（稱為返回類型）。 + +每個函數有個函數名，用來描述函數執行的任務。要使用一個函數時，你用函數名「調用」，並傳給它匹配的輸入值（稱作實參，arguments）。一個函數的實參必須與函數參數表裡參數的順序一致。 + +在下面例子中的函數叫做`"greetingForPerson"`，之所以叫這個名字是因為這個函數用一個人的名字當做輸入，並返回給這個人的問候語。為了完成這個任務，你定義一個輸入參數-一個叫做 `personName` 的 `String` 值，和一個包含給這個人問候語的 `String` 類型的返回值： + +```swift +func sayHello(personName: String) -> String { + let greeting = "Hello, " + personName + "!" + return greeting +} +``` + +所有的這些信息匯總起來成為函數的定義，並以 `func` 作為前綴。指定函數返回類型時，用返回箭頭 `->`（一個連字符後跟一個右尖括號）後跟返回類型的名稱的方式來表示。 + +該定義描述了函數做什麼，它期望接收什麼和執行結束時它返回的結果是什麼。這樣的定義使的函數可以在別的地方以一種清晰的方式被調用： + +```swift +println(sayHello("Anna")) +// prints "Hello, Anna!" +println(sayHello("Brian")) +// prints "Hello, Brian!" +``` + +調用 `sayHello` 函數時，在圓括號中傳給它一個 `String` 類型的實參。因為這個函數返回一個 `String` 類型的值，`sayHello` 可以被包含在 `println` 的調用中，用來輸出這個函數的返回值，正如上面所示。 + +在 `sayHello` 的函數體中，先定義了一個新的名為 `greeting` 的 `String` 常量，同時賦值了給 `personName` 的一個簡單問候消息。然後用 `return` 關鍵字把這個問候返回出去。一旦 `return greeting` 被調用，該函數結束它的執行並返回 `greeting` 的當前值。 + +你可以用不同的輸入值多次調用 `sayHello`。上面的例子展示的是用`"Anna"`和`"Brian"`調用的結果，該函數分別返回了不同的結果。 + +為了簡化這個函數的定義，可以將問候消息的創建和返回寫成一句： + +```swift +func sayHelloAgain(personName: String) -> String { + return "Hello again, " + personName + "!" +} +println(sayHelloAgain("Anna")) +// prints "Hello again, Anna!" +``` + + +## 函數參數與返回值（Function Parameters and Return Values） + +函數參數與返回值在Swift中極為靈活。你可以定義任何類型的函數，包括從只帶一個未名參數的簡單函數到複雜的帶有表達性參數名和不同參數選項的複雜函數。 + +### 多重輸入參數（Multiple Input Parameters） + +函數可以有多個輸入參數，寫在圓括號中，用逗號分隔。 + +下面這個函數用一個半開區間的開始點和結束點，計算出這個範圍內包含多少數字： + +```swift +func halfOpenRangeLength(start: Int, end: Int) -> Int { + return end - start +} +println(halfOpenRangeLength(1, 10)) +// prints "9" +``` + +### 無參函數（Functions Without Parameters） + +函數可以沒有參數。下面這個函數就是一個無參函數，當被調用時，它返回固定的 `String` 消息： + +```swift +func sayHelloWorld() -> String { + return "hello, world" +} +println(sayHelloWorld()) +// prints "hello, world" +``` + +儘管這個函數沒有參數，但是定義中在函數名後還是需要一對圓括號。當被調用時，也需要在函數名後寫一對圓括號。 + +### 無返回值函數（Functions Without Return Values） + +函數可以沒有返回值。下面是 `sayHello` 函數的另一個版本，叫 `waveGoodbye`，這個函數直接輸出 `String` 值，而不是返回它： + +```swift +func sayGoodbye(personName: String) { + println("Goodbye, \(personName)!") +} +sayGoodbye("Dave") +// prints "Goodbye, Dave!" +``` + +因為這個函數不需要返回值，所以這個函數的定義中沒有返回箭頭（->）和返回類型。 + +> 注意： +> 嚴格上來說，雖然沒有返回值被定義，`sayGoodbye` 函數依然返回了值。沒有定義返回類型的函數會返回特殊的值，叫 `Void`。它其實是一個空的元組（tuple），沒有任何元素，可以寫成`()`。 + +被調用時，一個函數的返回值可以被忽略： + +```swift +func printAndCount(stringToPrint: String) -> Int { + println(stringToPrint) + return countElements(stringToPrint) +} +func printWithoutCounting(stringToPrint: String) { + printAndCount(stringToPrint) +} +printAndCount("hello, world") +// prints "hello, world" and returns a value of 12 +printWithoutCounting("hello, world") +// prints "hello, world" but does not return a value + +``` + +第一個函數 `printAndCount`，輸出一個字符串並返回 `Int` 類型的字符數。第二個函數 `printWithoutCounting`調用了第一個函數，但是忽略了它的返回值。當第二個函數被調用時，消息依然會由第一個函數輸出，但是返回值不會被用到。 + +> 注意： +> 返回值可以被忽略，但定義了有返回值的函數必須返回一個值，如果在函數定義底部沒有返回任何值，這將導致編譯錯誤（compile-time error）。 + +### 多重返回值函數（Functions with Multiple Return Values） + +你可以用元組（tuple）類型讓多個值作為一個復合值從函數中返回。 + +下面的這個例子中，`count` 函數用來計算一個字符串中元音，輔音和其他字母的個數（基於美式英語的標準）。 + +```swift +func count(string: String) -> (vowels: Int, consonants: Int, others: Int) { + var vowels = 0, consonants = 0, others = 0 + for character in string { + switch String(character).lowercaseString { + case "a", "e", "i", "o", "u": + ++vowels + case "b", "c", "d", "f", "g", "h", "j", "k", "l", "m", + "n", "p", "q", "r", "s", "t", "v", "w", "x", "y", "z": + ++consonants + default: + ++others + } + } + return (vowels, consonants, others) +} +``` + +你可以用 `count` 函數來處理任何一個字符串，返回的值將是一個包含三個 `Int` 型值的元組（tuple）： + +```swift +let total = count("some arbitrary string!") +println("\(total.vowels) vowels and \(total.consonants) consonants") +// prints "6 vowels and 13 consonants" +``` + +需要注意的是，元組的成員不需要在函數中返回時命名，因為它們的名字已經在函數返回類型中有了定義。 + + +## 函數參數名稱（Function Parameter Names） + +以上所有的函數都給它們的參數定義了`參數名（parameter name）`： + +```swift +func someFunction(parameterName: Int) { + // function body goes here, and can use parameterName + // to refer to the argument value for that parameter +} +``` + +但是，這些參數名僅在函數體中使用，不能在函數調用時使用。這種類型的參數名被稱作`局部參數名（local parameter name）`，因為它們只能在函數體中使用。 + +### 外部參數名（External Parameter Names） + +有時候，調用函數時，給每個參數命名是非常有用的，因為這些參數名可以指出各個實參的用途是什麼。 + +如果你希望函數的使用者在調用函數時提供參數名字，那就需要給每個參數除了局部參數名外再定義一個`外部參數名`。外部參數名寫在局部參數名之前，用空格分隔。 + +```swift +func someFunction(externalParameterName localParameterName: Int) { + // function body goes here, and can use localParameterName + // to refer to the argument value for that parameter +} +``` + +> 注意： +> 如果你提供了外部參數名，那麼函數在被調用時，必須使用外部參數名。 + +以下是個例子，這個函數使用一個`結合者（joiner）`把兩個字符串聯在一起： + +```swift +func join(s1: String, s2: String, joiner: String) -> String { + return s1 + joiner + s2 +} +``` + +當你調用這個函數時，這三個字符串的用途是不清楚的： + +```swift +join("hello", "world", ", ") +// returns "hello, world" +``` + +為了讓這些字符串的用途更為明顯，我們為 `join` 函數添加外部參數名： + +```swift +func join(string s1: String, toString s2: String, withJoiner joiner: String) -> String { + return s1 + joiner + s2 +} +``` + +在這個版本的 `join` 函數中，第一個參數有一個叫 `string` 的外部參數名和 `s1` 的局部參數名，第二個參數有一個叫 `toString` 的外部參數名和 `s2` 的局部參數名，第三個參數有一個叫 `withJoiner` 的外部參數名和 `joiner` 的局部參數名。 + +現在，你可以使用這些外部參數名以一種清晰地方式來調用函數了： + +```swift +join(string: "hello", toString: "world", withJoiner: ", ") +// returns "hello, world" +``` + +使用外部參數名讓第二個版本的 `join` 函數的調用更為有表現力，更為通順，同時還保持了函數體是可讀的和有明確意圖的。 + +> 注意： +> 當其他人在第一次讀你的代碼，函數參數的意圖顯得不明顯時，考慮使用外部參數名。如果函數參數名的意圖是很明顯的，那就不需要定義外部參數名了。 + +### 簡寫外部參數名（Shorthand External Parameter Names） + +如果你需要提供外部參數名，但是局部參數名已經定義好了，那麼你不需要寫兩次參數名。相反，只寫一次參數名，並用`井號（#）`作為前綴就可以了。這告訴 Swift 使用這個參數名作為局部和外部參數名。 + +下面這個例子定義了一個叫 `containsCharacter` 的函數，使用`井號（#）`的方式定義了外部參數名： + +```swift +func containsCharacter(#string: String, #characterToFind: Character) -> Bool { + for character in string { + if character == characterToFind { + return true + } + } + return false +} +``` + +這樣定義參數名，使得函數體更為可讀，清晰，同時也可以以一個不含糊的方式被調用： + +```swift +let containsAVee = containsCharacter(string: "aardvark", characterToFind: "v") +// containsAVee equals true, because "aardvark" contains a "v」 +``` + +### 默認參數值（Default Parameter Values） + +你可以在函數體中為每個參數定義`默認值`。當默認值被定義後，調用這個函數時可以忽略這個參數。 + +> 注意： +> 將帶有默認值的參數放在函數參數列表的最後。這樣可以保證在函數調用時，非默認參數的順序是一致的，同時使得相同的函數在不同情況下調用時顯得更為清晰。 + +以下是另一個版本的`join`函數，其中`joiner`有了默認參數值： + +```swift +func join(string s1: String, toString s2: String, withJoiner joiner: String = " ") -> String { + return s1 + joiner + s2 +} +``` + +像第一個版本的 `join` 函數一樣，如果 `joiner` 被賦值時，函數將使用這個字符串值來連接兩個字符串： + +```swift +join(string: "hello", toString: "world", withJoiner: "-") +// returns "hello-world" +``` + +當這個函數被調用時，如果 `joiner` 的值沒有被指定，函數會使用默認值（" "）： + +```swift +join(string: "hello", toString:"world") +// returns "hello world" +``` + +### 默認值參數的外部參數名（External Names for Parameters with Default Values） + +在大多數情況下，給帶默認值的參數起一個外部參數名是很有用的。這樣可以保證當函數被調用且帶默認值的參數被提供值時，實參的意圖是明顯的。 + +為了使定義外部參數名更加簡單，當你未給帶默認值的參數提供外部參數名時，Swift 會自動提供外部名字。此時外部參數名與局部名字是一樣的，就像你已經在局部參數名前寫了`井號（#）`一樣。 + +下面是 `join` 函數的另一個版本，這個版本中並沒有為它的參數提供外部參數名，但是 `joiner` 參數依然有外部參數名： + +```swift +func join(s1: String, s2: String, joiner: String = " ") -> String { + return s1 + joiner + s2 +} +``` + +在這個例子中，Swift 自動為 `joiner` 提供了外部參數名。因此，當函數調用時，外部參數名必須使用，這樣使得參數的用途變得清晰。 + +```swift +join("hello", "world", joiner: "-") +// returns "hello-world" +``` + +> 注意： +> 你可以使用`下劃線（_）`作為默認值參數的外部參數名，這樣可以在調用時不用提供外部參數名。但是給帶默認值的參數命名總是更加合適的。 + +### 可變參數（Variadic Parameters） + +一個`可變參數（variadic parameter）`可以接受一個或多個值。函數調用時，你可以用可變參數來傳入不確定數量的輸入參數。通過在變量類型名後面加入`（...）`的方式來定義可變參數。 + +傳入可變參數的值在函數體內當做這個類型的一個數組。例如，一個叫做 `numbers` 的 `Double...` 型可變參數，在函數體內可以當做一個叫 `numbers` 的 `Double[]` 型的數組常量。 + +下面的這個函數用來計算一組任意長度數字的算術平均數： + +```swift +func arithmeticMean(numbers: Double...) -> Double { + var total: Double = 0 + for number in numbers { + total += number + } + return total / Double(numbers.count) +} +arithmeticMean(1, 2, 3, 4, 5) +// returns 3.0, which is the arithmetic mean of these five numbers +arithmeticMean(3, 8, 19) +// returns 10.0, which is the arithmetic mean of these three numbers +``` + +> 注意： +> 一個函數至多能有一個可變參數，而且它必須是參數表中最後的一個。這樣做是為了避免函數調用時出現歧義。 + +如果函數有一個或多個帶默認值的參數，而且還有一個可變參數，那麼把可變參數放在參數表的最後。 + +### 常量參數和變量參數（Constant and Variable Parameters） + +函數參數默認是常量。試圖在函數體中更改參數值將會導致編譯錯誤。這意味著你不能錯誤地更改參數值。 + +但是，有時候，如果函數中有傳入參數的變量值副本將是很有用的。你可以通過指定一個或多個參數為變量參數，從而避免自己在函數中定義新的變量。變量參數不是常量，你可以在函數中把它當做新的可修改副本來使用。 + +通過在參數名前加關鍵字 `var` 來定義變量參數： + +```swift +func alignRight(var string: String, count: Int, pad: Character) -> String { + let amountToPad = count - countElements(string) + for _ in 1...amountToPad { + string = pad + string + } + return string +} +let originalString = "hello" +let paddedString = alignRight(originalString, 10, "-") +// paddedString is equal to "-----hello" +// originalString is still equal to "hello" +``` + +這個例子中定義了一個新的叫做 `alignRight` 的函數，用來右對齊輸入的字符串到一個長的輸出字符串中。左側空餘的地方用指定的填充字符填充。這個例子中，字符串`"hello"`被轉換成了`"-----hello"`。 + +`alignRight` 函數將參數 `string` 定義為變量參數。這意味著 `string` 現在可以作為一個局部變量，用傳入的字符串值初始化，並且可以在函數體中進行操作。 + +該函數首先計算出多少個字符需要被添加到 `string` 的左邊，以右對齊到總的字符串中。這個值存在局部常量 `amountToPad` 中。這個函數然後將 `amountToPad` 多的填充（pad）字符填充到 `string` 左邊，並返回結果。它使用了 `string` 這個變量參數來進行所有字符串操作。 + +> 注意： +> 對變量參數所進行的修改在函數調用結束後便消失了，並且對於函數體外是不可見的。變量參數僅僅存在於函數調用的生命週期中。 + +### 輸入輸出參數（In-Out Parameters） + +變量參數，正如上面所述，僅僅能在函數體內被更改。如果你想要一個函數可以修改參數的值，並且想要在這些修改在函數調用結束後仍然存在，那麼就應該把這個參數定義為輸入輸出參數（In-Out Parameters）。 + +定義一個輸入輸出參數時，在參數定義前加 `inout` 關鍵字。一個輸入輸出參數有傳入函數的值，這個值被函數修改，然後被傳出函數，替換原來的值。 + +你只能傳入一個變量作為輸入輸出參數。你不能傳入常量或者字面量（literal value），因為這些量是不能被修改的。當傳入的參數作為輸入輸出參數時，需要在參數前加`&`符，表示這個值可以被函數修改。 + +> 注意： +> 輸入輸出參數不能有默認值，而且可變參數不能用 `inout` 標記。如果你用 `inout` 標記一個參數，這個參數不能被 `var` 或者 `let` 標記。 + +下面是例子，`swapTwoInts` 函數，有兩個分別叫做 `a` 和 `b` 的輸入輸出參數： + +```swift +func swapTwoInts(inout a: Int, inout b: Int) { + let temporaryA = a + a = b + b = temporaryA +} +``` + +這個 `swapTwoInts` 函數僅僅交換 `a` 與 `b` 的值。該函數先將 `a` 的值存到一個暫時常量 `temporaryA` 中，然後將 `b` 的值賦給 `a`，最後將 `temporaryA` 幅值給 `b`。 + +你可以用兩個 `Int` 型的變量來調用 `swapTwoInts`。需要注意的是，`someInt` 和 `anotherInt` 在傳入 `swapTwoInts` 函數前，都加了 `&` 的前綴： + +```swift +var someInt = 3 +var anotherInt = 107 +swapTwoInts(&someInt, &anotherInt) +println("someInt is now \(someInt), and anotherInt is now \(anotherInt)") +// prints "someInt is now 107, and anotherInt is now 3」 +``` + +從上面這個例子中，我們可以看到 `someInt` 和 `anotherInt` 的原始值在 `swapTwoInts` 函數中被修改，儘管它們的定義在函數體外。 + +> 注意： +> 輸出輸出參數和返回值是不一樣的。上面的 `swapTwoInts` 函數並沒有定義任何返回值，但仍然修改了 `someInt` 和 `anotherInt` 的值。輸入輸出參數是函數對函數體外產生影響的另一種方式。 + + +## 函數類型（Function Types） + +每個函數都有種特定的函數類型，由函數的參數類型和返回類型組成。 + +例如： + +```swift +func addTwoInts(a: Int, b: Int) -> Int { + return a + b +} +func multiplyTwoInts(a: Int, b: Int) -> Int { + return a * b +} +``` + +這個例子中定義了兩個簡單的數學函數：`addTwoInts` 和 `multiplyTwoInts`。這兩個函數都傳入兩個 `Int` 類型， 返回一個合適的`Int`值。 + +這兩個函數的類型是 `(Int, Int) -> Int`，可以讀作「這個函數類型，它有兩個 `Int` 型的參數並返回一個 `Int` 型的值。」。 + +下面是另一個例子，一個沒有參數，也沒有返回值的函數： + +```swift +func printHelloWorld() { + println("hello, world") +} +``` + +這個函數的類型是：`() -> ()`，或者叫「沒有參數，並返回 `Void` 類型的函數」。沒有指定返回類型的函數總返回 `Void`。在Swift中，`Void` 與空的元組是一樣的。 + +### 使用函數類型（Using Function Types） + +在 Swift 中，使用函數類型就像使用其他類型一樣。例如，你可以定義一個類型為函數的常量或變量，並將函數賦值給它： + +```swift +var mathFunction: (Int, Int) -> Int = addTwoInts +``` + +這個可以讀作： + +「定義一個叫做 `mathFunction` 的變量，類型是『一個有兩個 `Int` 型的參數並返回一個 `Int` 型的值的函數』，並讓這個新變量指向 `addTwoInts` 函數」。 + +`addTwoInts` 和 `mathFunction` 有同樣的類型，所以這個賦值過程在 Swift 類型檢查中是允許的。 + +現在，你可以用 `mathFunction` 來調用被賦值的函數了： + +```swift +println("Result: \(mathFunction(2, 3))") +// prints "Result: 5" +``` + +有相同匹配類型的不同函數可以被賦值給同一個變量，就像非函數類型的變量一樣： + +```swift +mathFunction = multiplyTwoInts +println("Result: \(mathFunction(2, 3))") +// prints "Result: 6" +``` + +就像其他類型一樣，當賦值一個函數給常量或變量時，你可以讓 Swift 來推斷其函數類型： + +```swift +let anotherMathFunction = addTwoInts +// anotherMathFunction is inferred to be of type (Int, Int) -> Int +``` + +### 函數類型作為參數類型（Function Types as Parameter Types） + +你可以用`(Int, Int) -> Int`這樣的函數類型作為另一個函數的參數類型。這樣你可以將函數的一部分實現交由給函數的調用者。 + +下面是另一個例子，正如上面的函數一樣，同樣是輸出某種數學運算結果： + +```swift +func printMathResult(mathFunction: (Int, Int) -> Int, a: Int, b: Int) { + println("Result: \(mathFunction(a, b))") +} +printMathResult(addTwoInts, 3, 5) +// prints "Result: 8」 +``` + +這個例子定義了 `printMathResult` 函數，它有三個參數：第一個參數叫 `mathFunction`，類型是`(Int, Int) -> Int`，你可以傳入任何這種類型的函數；第二個和第三個參數叫 `a` 和 `b`，它們的類型都是 `Int`，這兩個值作為已給的函數的輸入值。 + +當 `printMathResult` 被調用時，它被傳入 `addTwoInts` 函數和整數`3`和`5`。它用傳入`3`和`5`調用 `addTwoInts`，並輸出結果：`8`。 + +`printMathResult` 函數的作用就是輸出另一個合適類型的數學函數的調用結果。它不關心傳入函數是如何實現的，它只關心這個傳入的函數類型是正確的。這使得 `printMathResult` 可以以一種類型安全（type-safe）的方式來保證傳入函數的調用是正確的。 + +### 函數類型作為返回類型（Function Type as Return Types） + +你可以用函數類型作為另一個函數的返回類型。你需要做的是在返回箭頭（`->`）後寫一個完整的函數類型。 + +下面的這個例子中定義了兩個簡單函數，分別是 `stepForward` 和`stepBackward`。`stepForward` 函數返回一個比輸入值大一的值。`stepBackward` 函數返回一個比輸入值小一的值。這兩個函數的類型都是 `(Int) -> Int`： + +```swift +func stepForward(input: Int) -> Int { + return input + 1 +} +func stepBackward(input: Int) -> Int { + return input - 1 +} +``` + +下面這個叫做 `chooseStepFunction` 的函數，它的返回類型是 `(Int) -> Int` 的函數。`chooseStepFunction` 根據布爾值 `backwards` 來返回 `stepForward` 函數或 `stepBackward` 函數： + +```swift +func chooseStepFunction(backwards: Bool) -> (Int) -> Int { + return backwards ? stepBackward : stepForward +} +``` + +你現在可以用 `chooseStepFunction` 來獲得一個函數，不管是那個方向： + +```swift +var currentValue = 3 +let moveNearerToZero = chooseStepFunction(currentValue > 0) +// moveNearerToZero now refers to the stepBackward() function +``` + +上面這個例子中計算出從 `currentValue` 逐漸接近到`0`是需要向正數走還是向負數走。`currentValue` 的初始值是`3`，這意味著 `currentValue > 0` 是真的（`true`），這將使得 `chooseStepFunction` 返回 `stepBackward` 函數。一個指向返回的函數的引用保存在了 `moveNearerToZero` 常量中。 + +現在，`moveNearerToZero` 指向了正確的函數，它可以被用來數到`0`： + +```swift +println("Counting to zero:") +// Counting to zero: +while currentValue != 0 { + println("\(currentValue)... ") + currentValue = moveNearerToZero(currentValue) +} +println("zero!") +// 3... +// 2... +// 1... +// zero! +``` + + +## 嵌套函數（Nested Functions） + +這章中你所見到的所有函數都叫全局函數（global functions），它們定義在全局域中。你也可以把函數定義在別的函數體中，稱作嵌套函數（nested functions）。 + +默認情況下，嵌套函數是對外界不可見的，但是可以被他們封閉函數（enclosing function）來調用。一個封閉函數也可以返回它的某一個嵌套函數，使得這個函數可以在其他域中被使用。 + +你可以用返回嵌套函數的方式重寫 `chooseStepFunction` 函數： + +```swift +func chooseStepFunction(backwards: Bool) -> (Int) -> Int { + func stepForward(input: Int) -> Int { return input + 1 } + func stepBackward(input: Int) -> Int { return input - 1 } + return backwards ? stepBackward : stepForward +} +var currentValue = -4 +let moveNearerToZero = chooseStepFunction(currentValue > 0) +// moveNearerToZero now refers to the nested stepForward() function +while currentValue != 0 { + println("\(currentValue)... ") + currentValue = moveNearerToZero(currentValue) +} +println("zero!") +// -4... +// -3... +// -2... +// -1... +// zero! +``` diff --git a/source-tw/chapter2/07_Closures.md b/source-tw/chapter2/07_Closures.md new file mode 100644 index 00000000..73b12ee4 --- /dev/null +++ b/source-tw/chapter2/07_Closures.md @@ -0,0 +1,375 @@ +> 翻譯：[wh1100717](https://github.com/wh1100717) +> 校對：[lyuka](https://github.com/lyuka) + +# 閉包（Closures） +----------------- + +本頁包含內容： + +- [閉包表達式（Closure Expressions）](#closure_expressions) +- [尾隨閉包（Trailing Closures）](#trailing_closures) +- [值捕獲（Capturing Values）](#capturing_values) +- [閉包是引用類型（Closures Are Reference Types）](#closures_are_reference_types) + +閉包是自包含的函數代碼塊，可以在代碼中被傳遞和使用。 +Swift 中的閉包與 C 和 Objective-C 中的代碼塊（blocks）以及其他一些編程語言中的 lambdas 函數比較相似。 + +閉包可以捕獲和存儲其所在上下文中任意常量和變量的引用。 +這就是所謂的閉合併包裹著這些常量和變量，俗稱閉包。Swift 會為您管理在捕獲過程中涉及到的所有內存操作。 + +> 注意： +> 如果您不熟悉捕獲（capturing）這個概念也不用擔心，您可以在 [值捕獲](#capturing_values) 章節對其進行詳細瞭解。 + +在[函數](../chapter2/06_Functions.html) 章節中介紹的全局和嵌套函數實際上也是特殊的閉包，閉包採取如下三種形式之一： + +* 全局函數是一個有名字但不會捕獲任何值的閉包 +* 嵌套函數是一個有名字並可以捕獲其封閉函數域內值的閉包 +* 閉包表達式是一個利用輕量級語法所寫的可以捕獲其上下文中變量或常量值的匿名閉包 + +Swift 的閉包表達式擁有簡潔的風格，並鼓勵在常見場景中進行語法優化，主要優化如下： + +* 利用上下文推斷參數和返回值類型 +* 隱式返回單表達式閉包，即單表達式閉包可以省略`return`關鍵字 +* 參數名稱縮寫 +* 尾隨（Trailing）閉包語法 + + +## 閉包表達式（Closure Expressions） + + +[嵌套函數](../chapter2/06_Functions.html#nested_function) 是一個在較複雜函數中方便進行命名和定義自包含代碼模塊的方式。當然，有時候撰寫小巧的沒有完整定義和命名的類函數結構也是很有用處的，尤其是在您處理一些函數並需要將另外一些函數作為該函數的參數時。 + +閉包表達式是一種利用簡潔語法構建內聯閉包的方式。 +閉包表達式提供了一些語法優化，使得撰寫閉包變得簡單明瞭。 +下面閉包表達式的例子通過使用幾次迭代展示了`sort`函數定義和語法優化的方式。 +每一次迭代都用更簡潔的方式描述了相同的功能。 + + +### sort 函數（The Sort Function） + +Swift 標準庫提供了`sort`函數，會根據您提供的基於輸出類型排序的閉包涵數將已知類型數組中的值進行排序。 +一旦排序完成，函數會返回一個與原數組大小相同的新數組，該數組中包含已經正確排序的同類型元素。 + +下面的閉包表達式示例使用`sort`函數對一個`String`類型的數組進行字母逆序排序，以下是初始數組值： + +```swift +let names = ["Chris", "Alex", "Ewa", "Barry", "Daniella"] +``` + +`sort`函數需要傳入兩個參數： + +* 已知類型的數組 +* 閉包涵數，該閉包涵數需要傳入與數組類型相同的兩個值，並返回一個布爾類型值來告訴`sort`函數當排序結束後傳入的第一個參數排在第二個參數前面還是後面。如果第一個參數值出現在第二個參數值前面，排序閉包涵數需要返回`true`，反之返回`false`。 + +該例子對一個`String`類型的數組進行排序，因此排序閉包涵數類型需為`(String, String) -> Bool`。 + +提供排序閉包涵數的一種方式是撰寫一個符合其類型要求的普通函數，並將其作為`sort`函數的第二個參數傳入： + +```swift +func backwards(s1: String, s2: String) -> Bool { + return s1 > s2 +} +var reversed = sort(names, backwards) +// reversed 為 ["Ewa", "Daniella", "Chris", "Barry", "Alex"] +``` + +如果第一個字符串 (`s1`) 大於第二個字符串 (`s2`)，`backwards`函數返回`true`，表示在新的數組中`s1`應該出現在`s2`前。 +對於字符串中的字符來說，「大於」 表示 「按照字母順序較晚出現」。 +這意味著字母`"B"`大於字母`"A"`，字符串`"Tom"`大於字符串`"Tim"`。 +其將進行字母逆序排序，`"Barry"`將會排在`"Alex"`之後。 + +然而，這是一個相當冗長的方式，本質上只是寫了一個單表達式函數 (a > b)。 +在下面的例子中，利用閉合表達式語法可以更好的構造一個內聯排序閉包。 + + +### 閉包表達式語法（Closure Expression Syntax） + +閉包表達式語法有如下一般形式： + +```swift +{ (parameters) -> returnType in + statements +} +``` + +閉包表達式語法可以使用常量、變量和`inout`類型作為參數，不提供默認值。 +也可以在參數列表的最後使用可變參數。 +元組也可以作為參數和返回值。 + +下面的例子展示了之前`backwards`函數對應的閉包表達式版本的代碼： + +```swift +reversed = sort(names, { (s1: String, s2: String) -> Bool in + return s1 > s2 +}) +``` + +需要注意的是內聯閉包參數和返回值類型聲明與`backwards`函數類型聲明相同。 +在這兩種方式中，都寫成了`(s1: String, s2: String) -> Bool`。 +然而在內聯閉包表達式中，函數和返回值類型都寫在大括號內，而不是大括號外。 + +閉包的函數體部分由關鍵字`in`引入。 +該關鍵字表示閉包的參數和返回值類型定義已經完成，閉包涵數體即將開始。 + +因為這個閉包的函數體部分如此短以至於可以將其改寫成一行代碼： + +```swift +reversed = sort(names, { (s1: String, s2: String) -> Bool in return s1 > s2 } ) +``` + +這說明`sort`函數的整體調用保持不變，一對圓括號仍然包裹住了函數中整個參數集合。而其中一個參數現在變成了內聯閉包（相比於`backwards`版本的代碼）。 + + +### 根據上下文推斷類型（Inferring Type From Context） + +因為排序閉包涵數是作為`sort`函數的參數進行傳入的，Swift可以推斷其參數和返回值的類型。 +`sort`期望第二個參數是類型為`(String, String) -> Bool`的函數，因此實際上`String`,`String`和`Bool`類型並不需要作為閉包表達式定義中的一部分。 +因為所有的類型都可以被正確推斷，返回箭頭 (`->`) 和圍繞在參數周圍的括號也可以被省略： + +```swift +reversed = sort(names, { s1, s2 in return s1 > s2 } ) +``` + +實際上任何情況下，通過內聯閉包表達式構造的閉包作為參數傳遞給函數時，都可以推斷出閉包的參數和返回值類型，這意味著您幾乎不需要利用完整格式構造任何內聯閉包。 + + +### 單表達式閉包隱式返回（Implicit Return From Single-Expression Clossures） + +單行表達式閉包可以通過隱藏`return`關鍵字來隱式返回單行表達式的結果，如上版本的例子可以改寫為： + +```swift +reversed = sort(names, { s1, s2 in s1 > s2 } ) +``` + +在這個例子中，`sort`函數的第二個參數函數類型明確了閉包必須返回一個`Bool`類型值。 +因為閉包涵數體只包含了一個單一表達式 (`s1 > s2`)，該表達式返回`Bool`類型值，因此這裡沒有歧義，`return`關鍵字可以省略。 + + +### 參數名稱縮寫（Shorthand Argument Names） + +Swift 自動為內聯函數提供了參數名稱縮寫功能，您可以直接通過`$0`,`$1`,`$2`來順序調用閉包的參數。 + +如果您在閉包表達式中使用參數名稱縮寫，您可以在閉包參數列表中省略對其的定義，並且對應參數名稱縮寫的類型會通過函數類型進行推斷。 +`in`關鍵字也同樣可以被省略，因為此時閉包表達式完全由閉包涵數體構成： + +```swift +reversed = sort(names, { $0 > $1 } ) +``` + +在這個例子中，`$0`和`$1`表示閉包中第一個和第二個`String`類型的參數。 + + +### 運算符函數（Operator Functions） + +實際上還有一種更簡短的方式來撰寫上面例子中的閉包表達式。 +Swift 的`String`類型定義了關於大於號 (`>`) 的字符串實現，其作為一個函數接受兩個`String`類型的參數並返回`Bool`類型的值。 +而這正好與`sort`函數的第二個參數需要的函數類型相符合。 +因此，您可以簡單地傳遞一個大於號，Swift可以自動推斷出您想使用大於號的字符串函數實現： + +```swift +reversed = sort(names, >) +``` + +更多關於運算符表達式的內容請查看 [運算符函數](../chapter2/23_Advanced_Operators.html#operator_functions)。 + + +## 尾隨閉包（Trailing Closures） + + +如果您需要將一個很長的閉包表達式作為最後一個參數傳遞給函數，可以使用尾隨閉包來增強函數的可讀性。 +尾隨閉包是一個書寫在函數括號之後的閉包表達式，函數支持將其作為最後一個參數調用。 + +```swift +func someFunctionThatTakesAClosure(closure: () -> ()) { + // 函數體部分 +} + +// 以下是不使用尾隨閉包進行函數調用 +someFunctionThatTakesAClosure({ + // 閉包主體部分 +}) + +// 以下是使用尾隨閉包進行函數調用 +someFunctionThatTakesAClosure() { + // 閉包主體部分 +} +``` + +> 注意： +> 如果函數只需要閉包表達式一個參數，當您使用尾隨閉包時，您甚至可以把`()`省略掉。 + +在上例中作為`sort`函數參數的字符串排序閉包可以改寫為： + +```swift +reversed = sort(names) { $0 > $1 } +``` + +當閉包非常長以至於不能在一行中進行書寫時，尾隨閉包變得非常有用。 +舉例來說，Swift 的`Array`類型有一個`map`方法，其獲取一個閉包表達式作為其唯一參數。 +數組中的每一個元素調用一次該閉包涵數，並返回該元素所映射的值(也可以是不同類型的值)。 +具體的映射方式和返回值類型由閉包來指定。 + +當提供給數組閉包涵數後，`map`方法將返回一個新的數組，數組中包含了與原數組一一對應的映射後的值。 + +下例介紹了如何在`map`方法中使用尾隨閉包將`Int`類型數組`[16,58,510]`轉換為包含對應`String`類型的數組`["OneSix", "FiveEight", "FiveOneZero"]`: + +```swift +let digitNames = [ + 0: "Zero", 1: "One", 2: "Two", 3: "Three", 4: "Four", + 5: "Five", 6: "Six", 7: "Seven", 8: "Eight", 9: "Nine" +] +let numbers = [16, 58, 510] +``` + +如上代碼創建了一個數字位和它們名字映射的英文版本字典。 +同時定義了一個準備轉換為字符串的整型數組。 + +您現在可以通過傳遞一個尾隨閉包給`numbers`的`map`方法來創建對應的字符串版本數組。 +需要注意的時調用`numbers.map`不需要在`map`後面包含任何括號，因為其只需要傳遞閉包表達式這一個參數，並且該閉包表達式參數通過尾隨方式進行撰寫： + +```swift +let strings = numbers.map { + (var number) -> String in + var output = "" + while number > 0 { + output = digitNames[number % 10]! + output + number /= 10 + } + return output +} +// strings 常量被推斷為字符串類型數組，即 String[] +// 其值為 ["OneSix", "FiveEight", "FiveOneZero"] +``` + +`map`在數組中為每一個元素調用了閉包表達式。 +您不需要指定閉包的輸入參數`number`的類型，因為可以通過要映射的數組類型進行推斷。 + +閉包`number`參數被聲明為一個變量參數（變量的具體描述請參看[常量參數和變量參數](../chapter2/06_Functions.html#constant_and_variable_parameters)），因此可以在閉包涵數體內對其進行修改。閉包表達式制定了返回類型為`String`，以表明存儲映射值的新數組類型為`String`。 + +閉包表達式在每次被調用的時候創建了一個字符串並返回。 +其使用求余運算符 (number % 10) 計算最後一位數字並利用`digitNames`字典獲取所映射的字符串。 + +> 注意： +> 字典`digitNames`下標後跟著一個歎號 (!)，因為字典下標返回一個可選值 (optional value)，表明即使該 key 不存在也不會查找失敗。 +> 在上例中，它保證了`number % 10`可以總是作為一個`digitNames`字典的有效下標 key。 +> 因此歎號可以用於強制解析 (force-unwrap) 存儲在可選下標項中的`String`類型值。 + +從`digitNames`字典中獲取的字符串被添加到輸出的前部，逆序建立了一個字符串版本的數字。 +（在表達式`number % 10`中，如果number為16，則返回6，58返回8，510返回0）。 + +`number`變量之後除以10。 +因為其是整數，在計算過程中未除盡部分被忽略。 +因此 16變成了1，58變成了5，510變成了51。 + +整個過程重複進行，直到`number /= 10`為0，這時閉包會將字符串輸出，而`map`函數則會將字符串添加到所映射的數組中。 + +上例中尾隨閉包語法在函數後整潔封裝了具體的閉包功能，而不再需要將整個閉包包裹在`map`函數的括號內。 + + +## 捕獲值（Capturing Values） + + +閉包可以在其定義的上下文中捕獲常量或變量。 +即使定義這些常量和變量的原域已經不存在，閉包仍然可以在閉包涵數體內引用和修改這些值。 + +Swift最簡單的閉包形式是嵌套函數，也就是定義在其他函數的函數體內的函數。 +嵌套函數可以捕獲其外部函數所有的參數以及定義的常量和變量。 + +下例為一個叫做`makeIncrementor`的函數，其包含了一個叫做`incrementor`嵌套函數。 +嵌套函數`incrementor`從上下文中捕獲了兩個值，`runningTotal`和`amount`。 +之後`makeIncrementor`將`incrementor`作為閉包返回。 +每次調用`incrementor`時，其會以`amount`作為增量增加`runningTotal`的值。 + +```swift +func makeIncrementor(forIncrement amount: Int) -> () -> Int { + var runningTotal = 0 + func incrementor() -> Int { + runningTotal += amount + return runningTotal + } + return incrementor +} +``` + +`makeIncrementor`返回類型為`() -> Int`。 +這意味著其返回的是一個函數，而不是一個簡單類型值。 +該函數在每次調用時不接受參數只返回一個`Int`類型的值。 +關於函數返回其他函數的內容，請查看[函數類型作為返回類型](../chapter2/06_Functions.html#function_types_as_return_types)。 + +`makeIncrementor`函數定義了一個整型變量`runningTotal`(初始為0) 用來存儲當前跑步總數。 +該值通過`incrementor`返回。 + +`makeIncrementor`有一個`Int`類型的參數，其外部命名為`forIncrement`， 內部命名為`amount`，表示每次`incrementor`被調用時`runningTotal`將要增加的量。 + +`incrementor`函數用來執行實際的增加操作。 +該函數簡單地使`runningTotal`增加`amount`，並將其返回。 + +如果我們單獨看這個函數，會發現看上去不同尋常： + +```swift +func incrementor() -> Int { + runningTotal += amount + return runningTotal +} +``` + +`incrementor`函數並沒有獲取任何參數，但是在函數體內訪問了`runningTotal`和`amount`變量。這是因為其通過捕獲在包含它的函數體內已經存在的`runningTotal`和`amount`變量而實現。 + +由於沒有修改`amount`變量，`incrementor`實際上捕獲並存儲了該變量的一個副本，而該副本隨著`incrementor`一同被存儲。 + +然而，因為每次調用該函數的時候都會修改`runningTotal`的值，`incrementor`捕獲了當前`runningTotal`變量的引用，而不是僅僅複製該變量的初始值。捕獲一個引用保證了當`makeIncrementor`結束時候並不會消失，也保證了當下一次執行`incrementor`函數時，`runningTotal`可以繼續增加。 + +> 注意： +> Swift 會決定捕獲引用還是拷貝值。 +> 您不需要標注`amount`或者`runningTotal`來聲明在嵌入的`incrementor`函數中的使用方式。 +> Swift 同時也處理`runingTotal`變量的內存管理操作，如果不再被`incrementor`函數使用，則會被清除。 + +下面代碼為一個使用`makeIncrementor`的例子： + +```swift +let incrementByTen = makeIncrementor(forIncrement: 10) +``` + +該例子定義了一個叫做`incrementByTen`的常量，該常量指向一個每次調用會加10的`incrementor`函數。 +調用這個函數多次可以得到以下結果： + +```swift +incrementByTen() +// 返回的值為10 +incrementByTen() +// 返回的值為20 +incrementByTen() +// 返回的值為30 +``` + +如果您創建了另一個`incrementor`，其會有一個屬於自己的獨立的`runningTotal`變量的引用。 +下面的例子中，`incrementBySevne`捕獲了一個新的`runningTotal`變量，該變量和`incrementByTen`中捕獲的變量沒有任何聯繫： + +```swift +let incrementBySeven = makeIncrementor(forIncrement: 7) +incrementBySeven() +// 返回的值為7 +incrementByTen() +// 返回的值為40 +``` + +> 注意： +> 如果您將閉包賦值給一個類實例的屬性，並且該閉包通過指向該實例或其成員來捕獲了該實例，您將創建一個在閉包和實例間的強引用環。 +> Swift 使用捕獲列表來打破這種強引用環。更多信息，請參考 [閉包引起的循環強引用](../chapter2/16_Automatic_Reference_Counting.html#strong_reference_cycles_for_closures)。 + + +## 閉包是引用類型（Closures Are Reference Types） + +上面的例子中，`incrementBySeven`和`incrementByTen`是常量，但是這些常量指向的閉包仍然可以增加其捕獲的變量值。 +這是因為函數和閉包都是引用類型。 + +無論您將函數/閉包賦值給一個常量還是變量，您實際上都是將常量/變量的值設置為對應函數/閉包的引用。 +上面的例子中，`incrementByTen`指向閉包的引用是一個常量，而並非閉包內容本身。 + +這也意味著如果您將閉包賦值給了兩個不同的常量/變量，兩個值都會指向同一個閉包： + +```swift +let alsoIncrementByTen = incrementByTen +alsoIncrementByTen() +// 返回的值為50 +``` diff --git a/source-tw/chapter2/08_Enumerations.md b/source-tw/chapter2/08_Enumerations.md new file mode 100644 index 00000000..4d02d0be --- /dev/null +++ b/source-tw/chapter2/08_Enumerations.md @@ -0,0 +1,251 @@ +> 翻譯：[yankuangshi](https://github.com/yankuangshi) +> 校對：[shinyzhu](https://github.com/shinyzhu) + +# 枚舉（Enumerations） +--- + +本頁內容包含： + +- [枚舉語法（Enumeration Syntax）](#enumeration_syntax) +- [匹配枚舉值與`Swith`語句（Matching Enumeration Values with a Switch Statement）](#matching_enumeration_values_with_a_switch_statement) +- [相關值（Associated Values）](#associated_values) +- [原始值（Raw Values）](#raw_values) + +枚舉定義了一個通用類型的一組相關的值，使你可以在你的代碼中以一個安全的方式來使用這些值。 + +如果你熟悉 C 語言，你就會知道，在 C 語言中枚舉指定相關名稱為一組整型值。Swift 中的枚舉更加靈活，不必給每一個枚舉成員提供一個值。如果一個值（被認為是「原始」值）被提供給每個枚舉成員，則該值可以是一個字符串，一個字符，或是一個整型值或浮點值。 + +此外，枚舉成員可以指定任何類型的相關值存儲到枚舉成員值中，就像其他語言中的聯合體（unions）和變體（variants）。你可以定義一組通用的相關成員作為枚舉的一部分，每一組都有不同的一組與它相關的適當類型的數值。 + +在 Swift 中，枚舉類型是一等（first-class）類型。它們採用了很多傳統上只被類（class）所支持的特徵，例如計算型屬性（computed properties），用於提供關於枚舉當前值的附加信息，□實例方法（instance methods），用於提供和枚舉所代表的值相關聯的功能。枚舉也可以定義構造函數（initializers）來提供一個初始成員值；可以在原始的實現基礎上擴展它們的功能；可以遵守協議（protocols）來提供標準的功能。 + +欲瞭解更多相關功能，請參見[屬性（Properties）](10_Properties.html)，[方法（Methods）](11_Methods.html)，[構造過程（Initialization）](14_Initialization.html)，[擴展（Extensions）](20_Extensions.html)和[協議（Protocols）](21_Protocols.html)。 + + +## 枚舉語法 + +使用`enum`關鍵詞並且把它們的整個定義放在一對大括號內： + +```swift +enum SomeEnumeration { + // enumeration definition goes here +} +``` + +以下是指南針四個方向的一個例子： + +```swift +enum CompassPoint { + case North + case South + case East + case West +} +``` + +一個枚舉中被定義的值（例如 `North`，`South`，`East`和`West`）是枚舉的***成員值***（或者***成員***）。`case`關鍵詞表明新的一行成員值將被定義。 + +> 注意： +> 不像 C 和 Objective-C 一樣，Swift 的枚舉成員在被創建時不會被賦予一個默認的整數值。在上面的`CompassPoints`例子中，`North`，`South`，`East`和`West`不是隱式的等於`0`，`1`，`2`和`3`。相反的，這些不同的枚舉成員在`CompassPoint`的一種顯示定義中擁有各自不同的值。 + +多個成員值可以出現在同一行上，用逗號隔開： + +```swift +enum Planet { + case Mercury, Venus, Earth, Mars, Jupiter, Saturn, Uranus, Neptune +} +``` + +每個枚舉定義了一個全新的類型。像 Swift 中其他類型一樣，它們的名字（例如`CompassPoint`和`Planet`）必須以一個大寫字母開頭。給枚舉類型起一個單數名字而不是複數名字，以便於讀起來更加容易理解： + +```swift +var directionToHead = CompassPoint.West +``` + +`directionToHead`的類型被推斷當它被`CompassPoint`的一個可能值初始化。一旦`directionToHead`被聲明為一個`CompassPoint`，你可以使用更短的點（.）語法將其設置為另一個`CompassPoint`的值： + +```swift +directionToHead = .East +``` + +`directionToHead`的類型已知時，當設定它的值時，你可以不再寫類型名。使用顯式類型的枚舉值可以讓代碼具有更好的可讀性。 + + +## 匹配枚舉值和`Switch`語句 + +你可以匹配單個枚舉值和`switch`語句： + +```swift +directionToHead = .South +switch directionToHead { +case .North: + println("Lots of planets have a north") +case .South: + println("Watch out for penguins") +case .East: + println("Where the sun rises") +case .West: + println("Where the skies are blue") +} +// 輸出 "Watch out for penguins」 +``` + +你可以如此理解這段代碼： + +「考慮`directionToHead`的值。當它等於`.North`，打印`「Lots of planets have a north」`。當它等於`.South`，打印`「Watch out for penguins」`。」 + +等等依次類推。 + +正如在[控制流（Control Flow）](05_Control_Flow.html)中介紹，當考慮一個枚舉的成員們時，一個`switch`語句必須全面。如果忽略了`.West`這種情況，上面那段代碼將無法通過編譯，因為它沒有考慮到`CompassPoint`的全部成員。全面性的要求確保了枚舉成員不會被意外遺漏。 + +當不需要匹配每個枚舉成員的時候，你可以提供一個默認`default`分支來涵蓋所有未明確被提出的任何成員： + +```swift +let somePlanet = Planet.Earth +switch somePlanet { +case .Earth: + println("Mostly harmless") +default: + println("Not a safe place for humans") +} +// 輸出 "Mostly harmless」 +``` + + +## 相關值（Associated Values） + +上一小節的例子演示了一個枚舉的成員是如何被定義（分類）的。你可以為`Planet.Earth`設置一個常量或則變量，並且在之後查看這個值。不管怎樣，如果有時候能夠把其他類型的相關值和成員值一起存儲起來會很有用。這能讓你存儲成員值之外的自定義信息，並且當你每次在代碼中使用該成員時允許這個信息產生變化。 + +你可以定義 Swift 的枚舉存儲任何類型的相關值，如果需要的話，每個成員的數據類型可以是各不相同的。枚舉的這種特性跟其他語言中的可辨識聯合（discriminated unions），標籤聯合（tagged unions），或者變體（variants）相似。 + +例如，假設一個庫存跟蹤系統需要利用兩種不同類型的條形碼來跟蹤商品。有些商品上標有 UPC-A 格式的一維碼，它使用數字 0 到 9。每一個條形碼都有一個代表「數字系統」的數字，該數字後接 10 個代表「標識符」的數字。最後一個數字是「檢查」位，用來驗證代碼是否被正確掃瞄： + + + +其他商品上標有 QR 碼格式的二維碼，它可以使用任何 ISO8859-1 字符，並且可以編碼一個最多擁有 2,953 字符的字符串: + + + +對於庫存跟蹤系統來說，能夠把 UPC-A 碼作為三個整型值的元組，和把 QR 碼作為一個任何長度的字符串存儲起來是方便的。 + +在 Swift 中，用來定義兩種商品條碼的枚舉是這樣子的： + +```swift +enum Barcode { + case UPCA(Int, Int, Int) + case QRCode(String) +} +``` + +以上代碼可以這麼理解： + +「定義一個名為`Barcode`的枚舉類型，它可以是`UPCA`的一個相關值（`Int`，`Int`，`Int`），或者`QRCode`的一個字符串類型（`String`）相關值。」 + +這個定義不提供任何`Int`或`String`的實際值，它只是定義了，當`Barcode`常量和變量等於`Barcode.UPCA`或`Barcode.QRCode`時，相關值的類型。 + +然後可以使用任何一種條碼類型創建新的條碼，如： + +```swift +var productBarcode = Barcode.UPCA(8, 85909_51226, 3) +``` + +以上例子創建了一個名為`productBarcode`的新變量，並且賦給它一個`Barcode.UPCA`的相關元組值`(8, 8590951226, 3)`。提供的「標識符」值在整數字中有一個下劃線，使其便於閱讀條形碼。 + +同一個商品可以被分配給一個不同類型的條形碼，如： + +```swift +productBarcode = .QRCode("ABCDEFGHIJKLMNOP") +``` + +這時，原始的`Barcode.UPCA`和其整數值被新的`Barcode.QRCode`和其字符串值所替代。條形碼的常量和變量可以存儲一個`.UPCA`或者一個`.QRCode`（連同它的相關值），但是在任何指定時間只能存儲其中之一。 + +像以前那樣，不同的條形碼類型可以使用一個 switch 語句來檢查，然而這次相關值可以被提取作為 switch 語句的一部分。你可以在`switch`的 case 分支代碼中提取每個相關值作為一個常量（用`let`前綴）或者作為一個變量（用`var`前綴）來使用： + +```swift +switch productBarcode { +case .UPCA(let numberSystem, let identifier, let check): + println("UPC-A with value of \(numberSystem), \(identifier), \(check).") +case .QRCode(let productCode): + println("QR code with value of \(productCode).") +} +// 輸出 "QR code with value of ABCDEFGHIJKLMNOP.」 +``` + +如果一個枚舉成員的所有相關值被提取為常量，或者它們全部被提取為變量，為了簡潔，你可以只放置一個`var`或者`let`標注在成員名稱前： + +```swift +switch productBarcode { +case let .UPCA(numberSystem, identifier, check): + println("UPC-A with value of \(numberSystem), \(identifier), \(check).") +case let .QRCode(productCode): + println("QR code with value of \(productCode).") +} +// 輸出 "QR code with value of ABCDEFGHIJKLMNOP." +``` + + +## 原始值（Raw Values） + +在[Associated Values](#raw_values)小節的條形碼例子中演示了一個枚舉的成員如何聲明它們存儲不同類型的相關值。作為相關值的替代，枚舉成員可以被默認值（稱為原始值）預先填充，其中這些原始值具有相同的類型。 + +這裡是一個枚舉成員存儲原始 ASCII 值的例子： + +```swift +enum ASCIIControlCharacter: Character { + case Tab = "\t" + case LineFeed = "\n" + case CarriageReturn = "\r" +} +``` + +在這裡，稱為`ASCIIControlCharacter`的枚舉的原始值類型被定義為字符型`Character`，並被設置了一些比較常見的 ASCII 控制字符。字符值的描述請詳見字符串和字符[`Strings and Characters`](03_Strings_and_Characters.html)部分。 + +注意，原始值和相關值是不相同的。當你開始在你的代碼中定義枚舉的時候原始值是被預先填充的值，像上述三個 ASCII 碼。對於一個特定的枚舉成員，它的原始值始終是相同的。相關值是當你在創建一個基於枚舉成員的新常量或變量時才會被設置，並且每次當你這麼做得時候，它的值可以是不同的。 + +原始值可以是字符串，字符，或者任何整型值或浮點型值。每個原始值在它的枚舉聲明中必須是唯一的。當整型值被用於原始值，如果其他枚舉成員沒有值時，它們會自動遞增。 + +下面的枚舉是對之前`Planet`這個枚舉的一個細化，利用原始整型值來表示每個 planet 在太陽系中的順序： + +```swift +enum Planet: Int { + case Mercury = 1, Venus, Earth, Mars, Jupiter, Saturn, Uranus, Neptune +} +``` + +自動遞增意味著`Planet.Venus`的原始值是`2`，依次類推。 + +使用枚舉成員的`toRaw`方法可以訪問該枚舉成員的原始值： + +```swift +let earthsOrder = Planet.Earth.toRaw() +// earthsOrder is 3 +``` + +使用枚舉的`fromRaw`方法來試圖找到具有特定原始值的枚舉成員。這個例子通過原始值`7`識別`Uranus`： + +```swift +let possiblePlanet = Planet.fromRaw(7) +// possiblePlanet is of type Planet? and equals Planet.Uranus +``` + +然而，並非所有可能的`Int`值都可以找到一個匹配的行星。正因為如此，`fromRaw`方法可以返回一個***可選***的枚舉成員。在上面的例子中，`possiblePlanet`是`Planet?`類型，或「可選的`Planet`」。 + +如果你試圖尋找一個位置為9的行星，通過`fromRaw`返回的可選`Planet`值將是`nil`： + +```swift +let positionToFind = 9 +if let somePlanet = Planet.fromRaw(positionToFind) { + switch somePlanet { + case .Earth: + println("Mostly harmless") + default: + println("Not a safe place for humans") + } +} else { + println("There isn't a planet at position \(positionToFind)") +} +// 輸出 "There isn't a planet at position 9 +``` + +這個範例使用可選綁定（optional binding），通過原始值`9`試圖訪問一個行星。`if let somePlanet = Planet.fromRaw(9)`語句獲得一個可選`Planet`，如果可選`Planet`可以被獲得，把`somePlanet`設置成該可選`Planet`的內容。在這個範例中，無法檢索到位置為`9`的行星，所以`else`分支被執行。 + diff --git a/source-tw/chapter2/09_Classes_and_Structures.md b/source-tw/chapter2/09_Classes_and_Structures.md new file mode 100644 index 00000000..a19a2fa8 --- /dev/null +++ b/source-tw/chapter2/09_Classes_and_Structures.md @@ -0,0 +1,443 @@ +> 翻譯：[JaySurplus](https://github.com/JaySurplus) +> 校對：[sg552](https://github.com/sg552) + +# 類和結構體 + +本頁包含內容： + +- [類和結構體對比](#comparing_classes_and_structures) +- [結構體和枚舉是值類型](#structures_and_enumerations_are_value_types) +- [類是引用類型](#classes_are_reference_types) +- [類和結構體的選擇](#choosing_between_classes_and_structures) +- [集合（collection）類型的賦值與複製行為](#assignment_and_copy_behavior_for_collection_types) + +類和結構體是人們構建代碼所用的一種通用且靈活的構造體。為了在類和結構體中實現各種功能，我們必須要嚴格按照常量、變量以及函數所規定的語法規則來定義屬性和添加方法。 + +與其他編程語言所不同的是，Swift 並不要求你為自定義類和結構去創建獨立的接口和實現文件。你所要做的是在一個單一文件中定義一個類或者結構體，系統將會自動生成面向其它代碼的外部接口。 + +> 注意： +通常一個`類`的實例被稱為`對像`。然而在Swift 中，類和結構體的關係要比在其他語言中更加的密切，本章中所討論的大部分功能都可以用在類和結構體上。因此，我們會主要使用`實例`而不是`對像`。 + + +###類和結構體對比 + +Swift 中類和結構體有很多共同點。共同處在於： + +* 定義屬性用於存儲值 +* 定義方法用於提供功能 +* 定義附屬腳本用於訪問值 +* 定義構造器用於生成初始化值 +* 通過擴展以增加默認實現的功能 +* 符合協議以對某類提供標準功能 + +更多信息請參見 [屬性](10_Properties.html)，[方法](11_Methods.html)，[下標腳本](12_Subscripts.html)，[初始過程](14_Initialization.html)，[擴展](20_Extensions.html)，和[協議](21_Protocols.html)。 + +與結構體相比，類還有如下的附加功能： + +* 繼承允許一個類繼承另一個類的特徵 +* 類型轉換允許在運行時檢查和解釋一個類實例的類型 +* 解構器允許一個類實例釋放任何其所被分配的資源 +* 引用計數允許對一個類的多次引用 + +更多信息請參見[繼承](http://)，[類型轉換](http://)，[初始化](http://)，和[自動引用計數](http://)。 + +> 注意： +結構體總是通過被複製的方式在代碼中傳遞，因此請不要使用引用計數。 + +### 定義 + +類和結構體有著類似的定義方式。我們通過關鍵字`class`和`struct`來分別表示類和結構體，並在一對大括號中定義它們的具體內容： + +```swift +class SomeClass { + // class definition goes here +} +struct SomeStructure { + // structure definition goes here +} +``` + +> 注意： +在你每次定義一個新類或者結構體的時候，實際上你是有效地定義了一個新的 Swift 類型。因此請使用 `UpperCamelCase` 這種方式來命名（如 `SomeClass` 和`SomeStructure`等），以便符合標準Swift 類型的大寫命名風格（如`String`，`Int`和`Bool`）。相反的，請使用`lowerCamelCase`這種方式為屬性和方法命名（如`framerate`和`incrementCount`），以便和類區分。 + +以下是定義結構體和定義類的示例： + +```swift +struct Resolution { + var width = 0 + var heigth = 0 +} +class VideoMode { + var resolution = Resolution() + var interlaced = false + var frameRate = 0.0 + var name: String? +} +``` + +在上面的示例中我們定義了一個名為`Resolution`的結構體，用來描述一個顯示器的像素分辨率。這個結構體包含了兩個名為`width`和`height`的存儲屬性。存儲屬性是捆綁和存儲在類或結構體中的常量或變量。當這兩個屬性被初始化為整數`0`的時候，它們會被推斷為`Int`類型。 + +在上面的示例中我們還定義了一個名為`VideoMode`的類，用來描述一個視頻顯示器的特定模式。這個類包含了四個儲存屬性變量。第一個是`分辨率`，它被初始化為一個新的`Resolution`結構體的實例，具有`Resolution`的屬性類型。新`VideoMode`實例同時還會初始化其它三個屬性，它們分別是，初始值為`false`(意為「non-interlaced video」)的`interlaced`，回放幀率初始值為`0.0`的`frameRate`和值為可選`String`的`name`。`name`屬性會被自動賦予一個默認值`nil`，意為「沒有`name`值」，因為它是一個可選類型。 + +### 類和結構體實例 + +`Resolution`結構體和`VideoMode`類的定義僅描述了什麼是`Resolution`和`VideoMode`。它們並沒有描述一個特定的分辨率（resolution）或者視頻模式（video mode）。為了描述一個特定的分辨率或者視頻模式，我們需要生成一個它們的實例。 + +生成結構體和類實例的語法非常相似： + +```swift +let someResolution = Resolution() +let someVideoMode = VideoMode() +``` + +結構體和類都使用構造器語法來生成新的實例。構造器語法的最簡單形式是在結構體或者類的類型名稱後跟隨一個空括弧，如`Resolution()`或`VideoMode()`。通過這種方式所創建的類或者結構體實例，其屬性均會被初始化為默認值。[構造過程](14_Initialization.html)章節會對類和結構體的初始化進行更詳細的討論。 + +### 屬性訪問 + +通過使用*點語法*（*dot syntax*），你可以訪問實例中所含有的屬性。其語法規則是，實例名後面緊跟屬性名，兩者通過點號(.)連接： + +```swift +println("The width of someResolution is \(someResolution.width)") +// 輸出 "The width of someResolution is 0" +``` + +在上面的例子中，`someResolution.width`引用`someResolution`的`width`屬性，返回`width`的初始值`0`。 + +你也可以訪問子屬性，如何`VideoMode`中`Resolution`屬性的`width`屬性： + +```swift +println("The width of someVideoMode is \(someVideoMode.resolution.width)") +// 輸出 "The width of someVideoMode is 0" +``` + +你也可以使用點語法為屬性變量賦值： + +```swift +someVideoMode.resolution.width = 12880 +println("The width of someVideoMode is now \(someVideoMode.resolution.width)") +// 輸出 "The width of someVideoMode is now 1280" +``` + +> 注意： +與 Objective-C 語言不同的是，Swift 允許直接設置結構體屬性的子屬性。上面的最後一個例子，就是直接設置了`someVideoMode`中`resolution`屬性的`width`這個子屬性，以上操作並不需要重新設置`resolution`屬性。 + +### 結構體類型的成員逐一構造器(Memberwise Initializers for structure Types) + +所有結構體都有一個自動生成的成員逐一構造器，用於初始化新結構體實例中成員的屬性。新實例中各個屬性的初始值可以通過屬性的名稱傳遞到成員逐一構造器之中： + +```swift +let vga = resolution(width:640, heigth: 480) +``` + +與結構體不同，類實例沒有默認的成員逐一構造器。[構造過程](14_Initialization.html)章節會對構造器進行更詳細的討論。 + + +## 結構體和枚舉是值類型 + +值類型被賦予給一個變量，常數或者本身被傳遞給一個函數的時候，實際上操作的是其的拷貝。 + +在之前的章節中，我們已經大量使用了值類型。實際上，在 Swift 中，所有的基本類型：整數（Integer）、浮點數（floating-point）、布爾值（Booleans）、字符串（string)、數組（array）和字典（dictionaries），都是值類型，並且都是以結構體的形式在後台所實現。 + +在 Swift 中，所有的結構體和枚舉都是值類型。這意味著它們的實例，以及實例中所包含的任何值類型屬性，在代碼中傳遞的時候都會被複製。 + +請看下面這個示例，其使用了前一個示例中`Resolution`結構體： + +```swift +let hd = Resolution(width: 1920, height: 1080) +var cinema = hd +``` + +在以上示例中，聲明了一個名為`hd`的常量，其值為一個初始化為全高清視頻分辨率（1920 像素寬，1080 像素高）的`Resolution`實例。 + +然後示例中又聲明了一個名為`cinema`的變量，其值為之前聲明的`hd`。因為`Resolution`是一個結構體，所以`cinema`的值其實是`hd`的一個拷貝副本，而不是`hd`本身。儘管`hd`和`cinema`有著相同的寬（width）和高（height）屬性，但是在後台中，它們是兩個完全不同的實例。 + +下面，為了符合數碼影院放映的需求（2048 像素寬，1080 像素高），`cinema`的`width`屬性需要作如下修改： + +```swift +cinema.width = 2048 +``` + +這裡，將會顯示`cinema`的`width`屬性確已改為了`2048`： + +```swift +println("cinema is now \(cinema.width) pixels wide") +// 輸出 "cinema is now 2048 pixels wide" +``` + +然而，初始的`hd`實例中`width`屬性還是`1920`： + +```swift +println("hd is still \(hd.width ) pixels wide") +// 輸出 "hd is still 1920 pixels wide" +``` + +在將`hd`賦予給`cinema`的時候，實際上是將`hd`中所存儲的`值（values）`進行拷貝，然後將拷貝的數據存儲到新的`cinema`實例中。結果就是兩個完全獨立的實例碰巧包含有相同的數值。由於兩者相互獨立，因此將`cinema`的`width`修改為`2048`並不會影響`hd`中的寬（width）。 + +枚舉也遵循相同的行為準則： + +```swift +enum CompassPoint { + case North, South, East, West +} +var currentDirection = CompassPoint.West +let rememberedDirection = currentDirection +currentDirection = .East +if rememberDirection == .West { + println("The remembered direction is still .West") +} +// 輸出 "The remembered direction is still .West" +``` + +上例中`rememberedDirection`被賦予了`currentDirection`的值（value），實際上它被賦予的是值（value）的一個拷貝。賦值過程結束後再修改`currentDirection`的值並不影響`rememberedDirection`所儲存的原始值（value）的拷貝。 + + +## 類是引用類型 + +與值類型不同，引用類型在被賦予到一個變量、常量或者被傳遞到一個函數時，操作的是引用，其並不是拷貝。因此，引用的是已存在的實例本身而不是其拷貝。 + +請看下面這個示例，其使用了之前定義的`VideoMode`類： + +```swift +let tenEighty = VideoMode() +tenEighty.resolution = hd +tenEighty.interlaced = true +tenEighty.name = "1080i" +tenEighty.frameRate = 25.0 +``` + +以上示例中，聲明了一個名為`tenEighty`的常量，其引用了一個`VideoMode`類的新實例。在之前的示例中，這個視頻模式（video mode）被賦予了HD分辨率（1920*1080）的一個拷貝（`hd`）。同時設置為交錯（interlaced）,命名為`「1080i」`。最後，其幀率是`25.0`幀每秒。 + +然後，`tenEighty` 被賦予名為`alsoTenEighty`的新常量，同時對`alsoTenEighty`的幀率進行修改： + +```swift +let alsoTenEighty = tenEighty +alsoTenEighty.frameRate = 30.0 +``` + +因為類是引用類型，所以`tenEight`和`alsoTenEight`實際上引用的是相同的`VideoMode`實例。換句話說，它們是同一個實例的兩種叫法。 + +下面，通過查看`tenEighty`的`frameRate`屬性，我們會發現它正確的顯示了基本`VideoMode`實例的新幀率，其值為`30.0`： + +```swift +println("The frameRate property of tenEighty is now \(tenEighty.frameRate)") +// 輸出 "The frameRate property of theEighty is now 30.0" +``` + +需要注意的是`tenEighty`和`alsoTenEighty`被聲明為*常量（（constants）*而不是變量。然而你依然可以改變`tenEighty.frameRate`和`alsoTenEighty.frameRate`,因為這兩個常量本身不會改變。它們並不`存儲`這個`VideoMode`實例，在後台僅僅是對`VideoMode`實例的引用。所以，改變的是被引用的基礎`VideoMode`的`frameRate`參數，而不改變常量的值。 + +### 恆等運算符 + +因為類是引用類型，有可能有多個常量和變量在後台同時引用某一個類實例。（對於結構體和枚舉來說，這並不成立。因為它們作為值類型，在被賦予到常量、變量或者傳遞到函數時，其值總是會被拷貝。） + +如果能夠判定兩個常量或者變量是否引用同一個類實例將會很有幫助。為了達到這個目的，Swift 內建了兩個恆等運算符： + +* 等價於 （ === ） +* 不等價於 （ !== ） + +以下是運用這兩個運算符檢測兩個常量或者變量是否引用同一個實例： + +```swift +if tenEighty === alsoTenTighty { + println("tenTighty and alsoTenEighty refer to the same Resolution instance.") +} +//輸出 "tenEighty and alsoTenEighty refer to the same Resolution instance." +``` + +請注意```「等價於"```（用三個等號表示，===） 與```「等於"```（用兩個等號表示，==）的不同： + +* 「等價於」表示兩個類類型（class type）的常量或者變量引用同一個類實例。 +* 「等於」表示兩個實例的值「相等」或「相同」，判定時要遵照類設計者定義定義的評判標準，因此相比於「相等」，這是一種更加合適的叫法。 + +當你在定義你的自定義類和結構體的時候，你有義務來決定判定兩個實例「相等」的標準。在章節[運算符函數(Operator Functions)](23_Advanced_Operators.html#operator_functions)中將會詳細介紹實現自定義「等於」和「不等於」運算符的流程。 + +### 指針 + +如果你有 C，C++ 或者 Objective-C 語言的經驗，那麼你也許會知道這些語言使用指針來引用內存中的地址。一個 Swift 常量或者變量引用一個引用類型的實例與 C 語言中的指針類似，不同的是並不直接指向內存中的某個地址，而且也不要求你使用星號（*）來表明你在創建一個引用。Swift 中這些引用與其它的常量或變量的定義方式相同。 + + +## 類和結構體的選擇 + +在你的代碼中，你可以使用類和結構體來定義你的自定義數據類型。 + +然而，結構體實例總是通過值傳遞，類實例總是通過引用傳遞。這意味兩者適用不同的任務。當你在考慮一個工程項目的數據構造和功能的時候，你需要決定每個數據構造是定義成類還是結構體。 + +按照通用的準則，當符合一條或多條以下條件時，請考慮構建結構體： + +* 結構體的主要目的是用來封裝少量相關簡單數據值。 +* 有理由預計一個結構體實例在賦值或傳遞時，封裝的數據將會被拷貝而不是被引用。 +* 任何在結構體中儲存的值類型屬性，也將會被拷貝，而不是被引用。 +* 結構體不需要去繼承另一個已存在類型的屬性或者行為。 + +合適的結構體候選者包括： + +* 幾何形狀的大小，封裝一個`width`屬性和`height`屬性，兩者均為`Double`類型。 +* 一定範圍內的路徑，封裝一個`start`屬性和`length`屬性，兩者均為`Int`類型。 +* 三維坐標系內一點，封裝`x`，`y`和`z`屬性，三者均為`Double`類型。 + +在所有其它案例中，定義一個類，生成一個它的實例，並通過引用來管理和傳遞。實際中，這意味著絕大部分的自定義數據構造都應該是類，而非結構體。 + + +## 集合（Collection）類型的賦值和拷貝行為 + +Swift 中`數組（Array）`和`字典（Dictionary）`類型均以結構體的形式實現。然而當數組被賦予一個常量或變量，或被傳遞給一個函數或方法時，其拷貝行為與字典和其它結構體有些許不同。 + +以下對`數組`和`結構體`的行為描述與對`NSArray`和`NSDictionary`的行為描述在本質上不同，後者是以類的形式實現，前者是以結構體的形式實現。`NSArray`和`NSDictionary`實例總是以對已有實例引用,而不是拷貝的方式被賦值和傳遞。 + +> 注意： +以下是對於數組，字典，字符串和其它值的`拷貝`的描述。 +在你的代碼中，拷貝好像是確實是在有拷貝行為的地方產生過。然而，在 Swift 的後台中，只有確有必要，`實際（actual）`拷貝才會被執行。Swift 管理所有的值拷貝以確保性能最優化的性能，所以你也沒有必要去避免賦值以保證最優性能。（實際賦值由系統管理優化） + +### 字典類型的賦值和拷貝行為 + +無論何時將一個`字典`實例賦給一個常量或變量，或者傳遞給一個函數或方法，這個字典會即會在賦值或調用發生時被拷貝。在章節[結構體和枚舉是值類型](#structures_and_enumerations_are_value_types)中將會對此過程進行詳細介紹。 + +如果`字典`實例中所儲存的鍵（keys）和/或值（values）是值類型（結構體或枚舉），當賦值或調用發生時，它們都會被拷貝。相反，如果鍵（keys）和/或值（values）是引用類型，被拷貝的將會是引用，而不是被它們引用的類實例或函數。`字典`的鍵和值的拷貝行為與結構體所儲存的屬性的拷貝行為相同。 + +下面的示例定義了一個名為`ages`的字典，其中儲存了四個人的名字和年齡。`ages`字典被賦予了一個名為`copiedAges`的新變量，同時`ages`在賦值的過程中被拷貝。賦值結束後，`ages`和`copiedAges`成為兩個相互獨立的字典。 + +```swift +var ages = ["Peter": 23, "Wei": 35, "Anish": 65, "Katya": 19] +var copiedAges = ages +``` + +這個字典的鍵（keys）是`字符串（String）`類型，值（values）是`整（Int）`類型。這兩種類型在Swift 中都是值類型（value types），所以當字典被拷貝時，兩者都會被拷貝。 + +我們可以通過改變一個字典中的年齡值（age value），檢查另一個字典中所對應的值，來證明`ages`字典確實是被拷貝了。如果在`copiedAges`字典中將`Peter`的值設為`24`，那麼`ages`字典仍然會返回修改前的值`23`： + +```swift +copiedAges["Peter"] = 24 +println(ages["Peter"]) +// 輸出 "23" +``` + +### 數組的賦值和拷貝行為 + +在Swift 中，`數組（Arrays）`類型的賦值和拷貝行為要比`字典（Dictionary）`類型的複雜的多。當操作數組內容時，`數組（Array）`能提供接近C語言的的性能，並且拷貝行為只有在必要時才會發生。 + +如果你將一個`數組（Array）`實例賦給一個變量或常量，或者將其作為參數傳遞給函數或方法調用，在事件發生時數組的內容`不`會被拷貝。相反，數組公用相同的元素序列。當你在一個數組內修改某一元素，修改結果也會在另一數組顯示。 + +對數組來說，拷貝行為僅僅當操作有可能修改數組`長度`時才會發生。這種行為包括了附加（appending）,插入（inserting）,刪除（removing）或者使用範圍下標（ranged subscript）去替換這一範圍內的元素。只有當數組拷貝確要發生時，數組內容的行為規則與字典中鍵值的相同，參見章節[集合（collection）類型的賦值與複製行為](#assignment_and_copy_behavior_for_collection_types。 + +下面的示例將一個`整數（Int）`數組賦給了一個名為`a`的變量，繼而又被賦給了變量`b`和`c`： + +```swift +var a = [1, 2, 3] +var b = a +var c = a +``` + +我們可以在`a`,`b`,`c`上使用下標語法以得到數組的第一個元素： + +```swift +println(a[0]) +// 1 +println(b[0]) +// 1 +println(c[0]) +// 1 +``` + +如果通過下標語法修改數組中某一元素的值，那麼`a`,`b`,`c`中的相應值都會發生改變。請注意當你用下標語法修改某一值時，並沒有拷貝行為伴隨發生，因為下表語法修改值時沒有改變數組長度的可能： + +```swift +a[0] = 42 +println(a[0]) +// 42 +println(b[0]) +// 42 +println(c[0]) +// 42 +``` + +然而，當你給`a`附加新元素時，數組的長度`會`改變。 +當附加元素這一事件發生時，Swift 會創建這個數組的一個拷貝。從此以後，`a`將會是原數組的一個獨立拷貝。 + +拷貝發生後，如果再修改`a`中元素值的話，`a`將會返回與`b`，`c`不同的結果，因為後兩者引用的是原來的數組： + +```swift +a.append(4) +a[0] = 777 +println(a[0]) +// 777 +println(b[0]) +// 42 +println(c[0]) +// 42 +``` + +### 確保數組的唯一性 + +在操作一個數組，或將其傳遞給函數以及方法調用之前是很有必要先確定這個數組是有一個唯一拷貝的。通過在數組變量上調用`unshare`方法來確定數組引用的唯一性。（當數組賦給常量時，不能調用`unshare`方法） + +如果一個數組被多個變量引用，在其中的一個變量上調用`unshare`方法，則會拷貝此數組，此時這個變量將會有屬於它自己的獨立數組拷貝。當數組僅被一個變量引用時，則不會有拷貝發生。 + +在上一個示例的最後，`b`和`c`都引用了同一個數組。此時在`b`上調用`unshare`方法則會將`b`變成一個唯一個拷貝： + +```swift +b.unshare() +``` + +在`unshare`方法調用後再修改`b`中第一個元素的值，這三個數組（`a`,`b`,`c`）會返回不同的三個值： + +```swift +b[0] = -105 +println(a[0]) +// 77 +println(b[0]) +// -105 +println(c[0]) +// 42 +``` + + +### 判定兩個數組是否共用相同元素 + +我們通過使用恆等運算符（identity operators）（ === 和 !==）來判定兩個數組或子數組共用相同的儲存空間或元素。 + +下面這個示例使用了「等同（identical to）」 運算符（===） 來判定`b`和`c`是否共用相同的數組元素： + +```swift +if b === c { + println("b and c still share the same array elements.") +} else { + println("b and c now refer to two independent sets of array elements.") +} +``` + +```swift +// 輸出 "b and c now refer totwo independent sets of array elements." +``` + +此外，我們還可以使用恆等運算符來判定兩個子數組是否共用相同的元素。下面這個示例中，比較了`b`的兩個相等的子數組，並且確定了這兩個子數組都引用相同的元素： + +```swift +if b[0...1] === b[0...1] { + println("These two subarrays share the same elements.") +} else { + println("These two subarrays do not share the same elements.") +} +// 輸出 "These two subarrays share the same elements." +``` + +### 強制複製數組 + +我們通過調用數組的`copy`方法進行強制顯式複製。這個方法對數組進行了淺拷貝（shallow copy），並且返回一個包含此拷貝數組的新數組。 + +下面這個示例中定義了一個`names`數組，其包含了七個人名。還定義了一個`copiedNames`變量，用以儲存在`names`上調用`copy`方法所返回的結果： + +```swift +var names = ["Mohsen", "Hilary", "Justyn", "Amy", "Rich", "Graham", "Vic"] +var copiedNames = names.copy() +``` + +我們可以通過修改數組中某一個元素，並且檢查另一個數組中對應元素的方法來判定`names`數組確已被複製。如果你將`copiedNames`中第一個元素從"`Mohsen`"修改為"`Mo`",則`names`數組返回的仍是拷貝發生前的"`Mohsen`"： + +```swift +copiedName[0] = "Mo" +println(name[0]) +// 輸出 "Mohsen" +``` + +> 注意： +如果你僅需要確保你對數組的引用是唯一引用，請調用`unshare`方法，而不是`copy`方法。`unshare`方法僅會在確有必要時才會創建數組拷貝。`copy`方法會在任何時候都創建一個新的拷貝，即使引用已經是唯一引用。 + diff --git a/source-tw/chapter2/10_Properties.md b/source-tw/chapter2/10_Properties.md new file mode 100644 index 00000000..e9d83cd5 --- /dev/null +++ b/source-tw/chapter2/10_Properties.md @@ -0,0 +1,428 @@ +> 翻譯：[shinyzhu](https://github.com/shinyzhu) +> 校對：[pp-prog](https://github.com/pp-prog) + +# 屬性 (Properties) +--- + +本頁包含內容： + +- [存儲屬性（Stored Properties）](#stored_properties) +- [計算屬性（Computed Properties）](#computed_properties) +- [屬性觀察器（Property Observers）](#property_observers) +- [全局變量和局部變量（Global and Local Variables）](global_and_local_variables) +- [類型屬性（Type Properties）](#type_properties) + +**屬性**將值跟特定的類、結構或枚舉關聯。存儲屬性存儲常量或變量作為實例的一部分，計算屬性計算（而不是存儲）一個值。計算屬性可以用於類、結構體和枚舉裡，存儲屬性只能用於類和結構體。 + +存儲屬性和計算屬性通常用於特定類型的實例，但是，屬性也可以直接用於類型本身，這種屬性稱為類型屬性。 + +另外，還可以定義屬性觀察器來監控屬性值的變化，以此來觸發一個自定義的操作。屬性觀察器可以添加到自己寫的存儲屬性上，也可以添加到從父類繼承的屬性上。 + + +## 存儲屬性 + +簡單來說，一個存儲屬性就是存儲在特定類或結構體的實例裡的一個常量或變量，存儲屬性可以是*變量存儲屬性*（用關鍵字`var`定義），也可以是*常量存儲屬性*（用關鍵字`let`定義）。 + +可以在定義存儲屬性的時候指定默認值，請參考[構造過程](../chapter2/14_Initialization.html)一章的[默認屬性值](../chapter2/14_Initialization.html#default_property_values)一節。也可以在構造過程中設置或修改存儲屬性的值，甚至修改常量存儲屬性的值，請參考[構造過程](../chapter2/14_Initialization.html)一章的[在初始化階段修改常量存儲屬性](../chapter2/14_Initialization.html#modifying_constant_properties_during_initialization)一節。 + +下面的例子定義了一個名為`FixedLengthRange`的結構體，它描述了一個在創建後無法修改值域寬度的區間： + +```swift +struct FixedLengthRange { + var firstValue: Int + let length: Int +} +var rangeOfThreeItems = FixedLengthRange(firstValue: 0, length: 3) +// 該區間表示整數0，1，2 +rangeOfThreeItems.firstValue = 6 +// 該區間現在表示整數6，7，8 +``` + +`FixedLengthRange`的實例包含一個名為`firstValue`的變量存儲屬性和一個名為`length`的常量存儲屬性。在上面的例子中，`length`在創建實例的時候被賦值，因為它是一個常量存儲屬性，所以之後無法修改它的值。 + + +### 常量和存儲屬性 + +如果創建了一個結構體的實例並賦值給一個常量，則無法修改實例的任何屬性，即使定義了變量存儲屬性： + +```swift +let rangeOfFourItems = FixedLengthRange(firstValue: 0, length: 4) +// 該區間表示整數0，1，2，3 +rangeOfFourItems.firstValue = 6 +// 儘管 firstValue 是個變量屬性，這裡還是會報錯 +``` + +因為`rangeOfFourItems`聲明成了常量（用`let`關鍵字），即使`firstValue`是一個變量屬性，也無法再修改它了。 + +這種行為是由於結構體（struct）屬於*值類型*。當值類型的實例被聲明為常量的時候，它的所有屬性也就成了常量。 + +屬於*引用類型*的類（class）則不一樣，把一個引用類型的實例賦給一個常量後，仍然可以修改實例的變量屬性。 + + +### 延遲存儲屬性 + +延遲存儲屬性是指當第一次被調用的時候才會計算其初始值的屬性。在屬性聲明前使用`@lazy`來標示一個延遲存儲屬性。 + +> 注意： +> 必須將延遲存儲屬性聲明成變量（使用`var`關鍵字），因為屬性的值在實例構造完成之前可能無法得到。而常量屬性在構造過程完成之前必須要有初始值，因此無法聲明成延遲屬性。 + +延遲屬性很有用，當屬性的值依賴於在實例的構造過程結束前無法知道具體值的外部因素時，或者當屬性的值需要複雜或大量計算時，可以只在需要的時候來計算它。 + +下面的例子使用了延遲存儲屬性來避免複雜類的不必要的初始化。例子中定義了`DataImporter`和`DataManager`兩個類，下面是部分代碼： + +```swift +class DataImporter { + /* + DataImporter 是一個將外部文件中的數據導入的類。 + 這個類的初始化會消耗不少時間。 + */ + var fileName = "data.txt" + // 這是提供數據導入功能 +} + +class DataManager { + @lazy var importer = DataImporter() + var data = String[]() + // 這是提供數據管理功能 +} + +let manager = DataManager() +manager.data += "Some data" +manager.data += "Some more data" +// DataImporter 實例的 importer 屬性還沒有被創建 +``` + +`DataManager`類包含一個名為`data`的存儲屬性，初始值是一個空的字符串（`String`）數組。雖然沒有寫出全部代碼，`DataManager`類的目的是管理和提供對這個字符串數組的訪問。 + +`DataManager`的一個功能是從文件導入數據，該功能由`DataImporter`類提供，`DataImporter`需要消耗不少時間完成初始化：因為它的實例在初始化時可能要打開文件，還要讀取文件內容到內存。 + +`DataManager`也可能不從文件中導入數據。所以當`DataManager`的實例被創建時，沒必要創建一個`DataImporter`的實例，更明智的是當用到`DataImporter`的時候才去創建它。 + +由於使用了`@lazy`，`importer`屬性只有在第一次被訪問的時候才被創建。比如訪問它的屬性`fileName`時： + +```swift +println(manager.importer.fileName) +// DataImporter 實例的 importer 屬性現在被創建了 +// 輸出 "data.txt」 +``` + + +### 存儲屬性和實例變量 + +如果您有過 Objective-C 經驗，應該知道Objective-C為類實例存儲值和引提供兩種方用。對於屬性來說，也可以使用實例變量作為屬性值的後端存儲。 + +Swift 編程語言中把這些理論統一用屬性來實現。Swift 中的屬性沒有對應的實例變量，屬性的後端存儲也無法直接訪問。這就避免了不同場景下訪問方式的困擾，同時也將屬性的定義簡化成一個語句。 +一個類型中屬性的全部信息——包括命名、類型和內存管理特徵——都在唯一一個地方（類型定義中）定義。 + + +## 計算屬性 + +除存儲屬性外，類、結構體和枚舉可以定義*計算屬性*，計算屬性不直接存儲值，而是提供一個 getter 來獲取值，一個可選的 setter 來間接設置其他屬性或變量的值。 + +```swift +struct Point { + var x = 0.0, y = 0.0 +} +struct Size { + var width = 0.0, height = 0.0 +} +struct Rect { + var origin = Point() + var size = Size() + var center: Point { + get { + let centerX = origin.x + (size.width / 2) + let centerY = origin.y + (size.height / 2) + return Point(x: centerX, y: centerY) + } + set(newCenter) { + origin.x = newCenter.x - (size.width / 2) + origin.y = newCenter.y - (size.height / 2) + } + } +} +var square = Rect(origin: Point(x: 0.0, y: 0.0), + size: Size(width: 10.0, height: 10.0)) +let initialSquareCenter = square.center +square.center = Point(x: 15.0, y: 15.0) +println("square.origin is now at (\(square.origin.x), \(square.origin.y))") +// 輸出 "square.origin is now at (10.0, 10.0)」 +``` + +這個例子定義了 3 個幾何形狀的結構體： + +- `Point`封裝了一個`(x, y)`的坐標 +- `Size`封裝了一個`width`和`height` +- `Rect`表示一個有原點和尺寸的矩形 + +`Rect`也提供了一個名為`center`的計算屬性。一個矩形的中心點可以從原點和尺寸來算出，所以不需要將它以顯式聲明的`Point`來保存。`Rect`的計算屬性`center`提供了自定義的 getter 和 setter 來獲取和設置矩形的中心點，就像它有一個存儲屬性一樣。 + +例子中接下來創建了一個名為`square`的`Rect`實例，初始值原點是`(0, 0)`，寬度高度都是`10`。如圖所示藍色正方形。 + +`square`的`center`屬性可以通過點運算符（`square.center`）來訪問，這會調用 getter 來獲取屬性的值。跟直接返回已經存在的值不同，getter 實際上通過計算然後返回一個新的`Point`來表示`square`的中心點。如代碼所示，它正確返回了中心點`(5, 5)`。 + +`center`屬性之後被設置了一個新的值`(15, 15)`，表示向右上方移動正方形到如圖所示橙色正方形的位置。設置屬性`center`的值會調用 setter 來修改屬性`origin`的`x`和`y`的值，從而實現移動正方形到新的位置。 + +Computed Properties sample + + +### 便捷 setter 聲明 + +如果計算屬性的 setter 沒有定義表示新值的參數名，則可以使用默認名稱`newValue`。下面是使用了便捷 setter 聲明的`Rect`結構體代碼： + +```swift +struct AlternativeRect { + var origin = Point() + var size = Size() + var center: Point { + get { + let centerX = origin.x + (size.width / 2) + let centerY = origin.y + (size.height / 2) + return Point(x: centerX, y: centerY) + } + set { + origin.x = newValue.x - (size.width / 2) + origin.y = newValue.y - (size.height / 2) + } + } +} +``` + + +### 只讀計算屬性 + +只有 getter 沒有 setter 的計算屬性就是*只讀計算屬性*。只讀計算屬性總是返回一個值，可以通過點運算符訪問，但不能設置新的值。 + +<<<<<<< HEAD +> 注意： +> 必須使用`var`關鍵字定義計算屬性，包括只讀計算屬性，因為他們的值不是固定的。`let`關鍵字只用來聲明常量屬性，表示初始化後再也無法修改的值。 +======= +> 注意： +> +> 必須使用`var`關鍵字定義計算屬性，包括只讀計算屬性，因為它們的值不是固定的。`let`關鍵字只用來聲明常量屬性，表示初始化後再也無法修改的值。 +>>>>>>> a516af6a531a104ec88da0d236ecf389a5ec72af + +只讀計算屬性的聲明可以去掉`get`關鍵字和花括號： + +```swift +struct Cuboid { + var width = 0.0, height = 0.0, depth = 0.0 + var volume: Double { + return width * height * depth + } +} +let fourByFiveByTwo = Cuboid(width: 4.0, height: 5.0, depth: 2.0) +println("the volume of fourByFiveByTwo is \(fourByFiveByTwo.volume)") +// 輸出 "the volume of fourByFiveByTwo is 40.0" +``` + +這個例子定義了一個名為`Cuboid`的結構體，表示三維空間的立方體，包含`width`、`height`和`depth`屬性，還有一個名為`volume`的只讀計算屬性用來返回立方體的體積。設置`volume`的值毫無意義，因為通過`width`、`height`和`depth`就能算出`volume`。然而，`Cuboid`提供一個只讀計算屬性來讓外部用戶直接獲取體積是很有用的。 + + +## 屬性觀察器 + +*屬性觀察器*監控和響應屬性值的變化，每次屬性被設置值的時候都會調用屬性觀察器，甚至新的值和現在的值相同的時候也不例外。 + +可以為除了延遲存儲屬性之外的其他存儲屬性添加屬性觀察器，也可以通過重載屬性的方式為繼承的屬性（包括存儲屬性和計算屬性）添加屬性觀察器。屬性重載請參考[繼承](chapter/13_Inheritance.html)一章的[重載](chapter/13_Inheritance.html#overriding)。 + +> 注意： +> 不需要為無法重載的計算屬性添加屬性觀察器，因為可以通過 setter 直接監控和響應值的變化。 + +可以為屬性添加如下的一個或全部觀察器： + +- `willSet`在設置新的值之前調用 +- `didSet`在新的值被設置之後立即調用 + +`willSet`觀察器會將新的屬性值作為固定參數傳入，在`willSet`的實現代碼中可以為這個參數指定一個名稱，如果不指定則參數仍然可用，這時使用默認名稱`newValue`表示。 + +類似地，`didSet`觀察器會將舊的屬性值作為參數傳入，可以為該參數命名或者使用默認參數名`oldValue`。 + +<<<<<<< HEAD +> 注意： +> `willSet`和`didSet`觀察器在屬性初始化過程中不會被調用，他們只會當屬性的值在初始化之外的地方被設置時被調用。 +======= +> 注意： +> +> `willSet`和`didSet`觀察器在屬性初始化過程中不會被調用，它們只會當屬性的值在初始化之外的地方被設置時被調用。 +>>>>>>> a516af6a531a104ec88da0d236ecf389a5ec72af + +這裡是一個`willSet`和`didSet`的實際例子，其中定義了一個名為`StepCounter`的類，用來統計當人步行時的總步數，可以跟計步器或其他日常鍛煉的統計裝置的輸入數據配合使用。 + +```swift +class StepCounter { + var totalSteps: Int = 0 { + willSet(newTotalSteps) { + println("About to set totalSteps to \(newTotalSteps)") + } + didSet { + if totalSteps > oldValue { + println("Added \(totalSteps - oldValue) steps") + } + } + } +} +let stepCounter = StepCounter() +stepCounter.totalSteps = 200 +// About to set totalSteps to 200 +// Added 200 steps +stepCounter.totalSteps = 360 +// About to set totalSteps to 360 +// Added 160 steps +stepCounter.totalSteps = 896 +// About to set totalSteps to 896 +// Added 536 steps +``` + +`StepCounter`類定義了一個`Int`類型的屬性`totalSteps`，它是一個存儲屬性，包含`willSet`和`didSet`觀察器。 + +當`totalSteps`設置新值的時候，它的`willSet`和`didSet`觀察器都會被調用，甚至當新的值和現在的值完全相同也會調用。 + +例子中的`willSet`觀察器將表示新值的參數自定義為`newTotalSteps`，這個觀察器只是簡單的將新的值輸出。 + +`didSet`觀察器在`totalSteps`的值改變後被調用，它把新的值和舊的值進行對比，如果總的步數增加了，就輸出一個消息表示增加了多少步。`didSet`沒有提供自定義名稱，所以默認值`oldValue`表示舊值的參數名。 + +> 注意： +> 如果在`didSet`觀察器裡為屬性賦值，這個值會替換觀察器之前設置的值。 + + +##全局變量和局部變量 + +計算屬性和屬性觀察器所描述的模式也可以用於*全局變量*和*局部變量*，全局變量是在函數、方法、閉包或任何類型之外定義的變量，局部變量是在函數、方法或閉包內部定義的變量。 + +前面章節提到的全局或局部變量都屬於存儲型變量，跟存儲屬性類似，它提供特定類型的存儲空間，並允許讀取和寫入。 + +另外，在全局或局部範圍都可以定義計算型變量和為存儲型變量定義觀察器，計算型變量跟計算屬性一樣，返回一個計算的值而不是存儲值，聲明格式也完全一樣。 + +> 注意： +> 全局的常量或變量都是延遲計算的，跟[延遲存儲屬性](#lazy_stored_properties)相似，不同的地方在於，全局的常量或變量不需要標記`@lazy`特性。 +> 局部範圍的常量或變量不會延遲計算。 + + +##類型屬性 + +實例的屬性屬於一個特定類型實例，每次類型實例化後都擁有自己的一套屬性值，實例之間的屬性相互獨立。 + +也可以為類型本身定義屬性，不管類型有多少個實例，這些屬性都只有唯一一份。這種屬性就是*類型屬性*。 + +類型屬性用於定義特定類型所有實例共享的數據，比如所有實例都能用的一個常量（就像 C 語言中的靜態常量），或者所有實例都能訪問的一個變量（就像 C 語言中的靜態變量）。 + +對於值類型（指結構體和枚舉）可以定義存儲型和計算型類型屬性，對於類（class）則只能定義計算型類型屬性。 + +值類型的存儲型類型屬性可以是變量或常量，計算型類型屬性跟實例的計算屬性一樣定義成變量屬性。 + +> 注意： +> 跟實例的存儲屬性不同，必須給存儲型類型屬性指定默認值，因為類型本身無法在初始化過程中使用構造器給類型屬性賦值。 + + +###類型屬性語法 + +在 C 或 Objective-C 中，靜態常量和靜態變量的定義是通過特定類型加上`global`關鍵字。在 Swift 編程語言中，類型屬性是作為類型定義的一部分寫在類型最外層的花括號內，因此它的作用範圍也就在類型支持的範圍內。 + +使用關鍵字`static`來定義值類型的類型屬性，關鍵字`class`來為類（class）定義類型屬性。下面的例子演示了存儲型和計算型類型屬性的語法： + +```swift +struct SomeStructure { + static var storedTypeProperty = "Some value." + static var computedTypeProperty: Int { + // 這裡返回一個 Int 值 + } +} +enum SomeEnumeration { + static var storedTypeProperty = "Some value." + static var computedTypeProperty: Int { + // 這裡返回一個 Int 值 + } +} +class SomeClass { + class var computedTypeProperty: Int { + // 這裡返回一個 Int 值 + } +} +``` + +> 注意： +> 例子中的計算型類型屬性是只讀的，但也可以定義可讀可寫的計算型類型屬性，跟實例計算屬性的語法類似。 + + +###獲取和設置類型屬性的值 + +跟實例的屬性一樣，類型屬性的訪問也是通過點運算符來進行，但是，類型屬性是通過類型本身來獲取和設置，而不是通過實例。比如： + +```swift +println(SomeClass.computedTypeProperty) +// 輸出 "42" + +println(SomeStructure.storedTypeProperty) +// 輸出 "Some value." +SomeStructure.storedTypeProperty = "Another value." +println(SomeStructure.storedTypeProperty) +// 輸出 "Another value.」 +``` + +下面的例子定義了一個結構體，使用兩個存儲型類型屬性來表示多個聲道的聲音電平值，每個聲道有一個 0 到 10 之間的整數表示聲音電平值。 + +後面的圖表展示了如何聯合使用兩個聲道來表示一個立體聲的聲音電平值。當聲道的電平值是 0，沒有一個燈會亮；當聲道的電平值是 10，所有燈點亮。本圖中，左聲道的電平是 9，右聲道的電平是 7。 + +Static Properties VUMeter + +上面所描述的聲道模型使用`AudioChannel`結構體來表示： + +```swift +struct AudioChannel { + static let thresholdLevel = 10 + static var maxInputLevelForAllChannels = 0 + var currentLevel: Int = 0 { + didSet { + if currentLevel > AudioChannel.thresholdLevel { + // 將新電平值設置為閥值 + currentLevel = AudioChannel.thresholdLevel + } + if currentLevel > AudioChannel.maxInputLevelForAllChannels { + // 存儲當前電平值作為新的最大輸入電平 + AudioChannel.maxInputLevelForAllChannels = currentLevel + } + } + } +} +``` + +結構`AudioChannel`定義了 2 個存儲型類型屬性來實現上述功能。第一個是`thresholdLevel`，表示聲音電平的最大上限閾值，它是一個取值為 10 的常量，對所有實例都可見，如果聲音電平高於 10，則取最大上限值 10（見後面描述）。 + +第二個類型屬性是變量存儲型屬性`maxInputLevelForAllChannels`，它用來表示所有`AudioChannel`實例的電平值的最大值，初始值是 0。 + +`AudioChannel`也定義了一個名為`currentLevel`的實例存儲屬性，表示當前聲道現在的電平值，取值為 0 到 10。 + +屬性`currentLevel`包含`didSet`屬性觀察器來檢查每次新設置後的屬性值，有如下兩個檢查： + +- 如果`currentLevel`的新值大於允許的閾值`thresholdLevel`，屬性觀察器將`currentLevel`的值限定為閾值`thresholdLevel`。 +- 如果修正後的`currentLevel`值大於任何之前任意`AudioChannel`實例中的值，屬性觀察器將新值保存在靜態屬性`maxInputLevelForAllChannels`中。 + +> 注意： +> 在第一個檢查過程中，`didSet`屬性觀察器將`currentLevel`設置成了不同的值，但這時不會再次調用屬性觀察器。 + +可以使用結構體`AudioChannel`來創建表示立體聲系統的兩個聲道`leftChannel`和`rightChannel`： + +```swift +var leftChannel = AudioChannel() +var rightChannel = AudioChannel() +``` + +如果將左聲道的電平設置成 7，類型屬性`maxInputLevelForAllChannels`也會更新成 7： + +```swift +leftChannel.currentLevel = 7 +println(leftChannel.currentLevel) +// 輸出 "7" +println(AudioChannel.maxInputLevelForAllChannels) +// 輸出 "7" +``` + +如果試圖將右聲道的電平設置成 11，則會將右聲道的`currentLevel`修正到最大值 10，同時`maxInputLevelForAllChannels`的值也會更新到 10： + +```swift +rightChannel.currentLevel = 11 +println(rightChannel.currentLevel) +// 輸出 "10" +println(AudioChannel.maxInputLevelForAllChannels) +// 輸出 "10" +``` diff --git a/source-tw/chapter2/11_Methods.md b/source-tw/chapter2/11_Methods.md new file mode 100644 index 00000000..9e35a555 --- /dev/null +++ b/source-tw/chapter2/11_Methods.md @@ -0,0 +1,309 @@ +> 翻譯：[pp-prog](https://github.com/pp-prog) +> 校對：[zqp](https://github.com/zqp) + +# 方法（Methods） +----------------- + +本頁包含內容： + +- [實例方法(Instance Methods](#instance_methods) +- [類型方法(Type Methods)](#type_methods) + +**方法**是與某些特定類型相關聯的函數。類、結構體、枚舉都可以定義實例方法；實例方法為給定類型的實例封裝了具體的任務與功能。類、結構體、枚舉也可以定義類型方法；類型方法與類型本身相關聯。類型方法與 Objective-C 中的類方法（class methods）相似。 + +結構體和枚舉能夠定義方法是 Swift 與 C/Objective-C 的主要區別之一。在 Objective-C 中，類是唯一能定義方法的類型。但在 Swift 中，你不僅能選擇是否要定義一個類/結構體/枚舉，還能靈活的在你創建的類型（類/結構體/枚舉）上定義方法。 + + +## 實例方法(Instance Methods) + +**實例方法**是屬於某個特定類、結構體或者枚舉類型實例的方法。實例方法提供訪問和修改實例屬性的方法或提供與實例目的相關的功能，並以此來支撐實例的功能。實例方法的語法與函數完全一致，詳情參見[函數](../charpter2/06_Functions.md)。 + +實例方法要寫在它所屬的類型的前後大括號之間。實例方法能夠隱式訪問它所屬類型的所有的其他實例方法和屬性。實例方法只能被它所屬的類的某個特定實例調用。實例方法不能脫離於現存的實例而被調用。 + +下面的例子，定義一個很簡單的類`Counter`，`Counter`能被用來對一個動作發生的次數進行計數： + +```swift +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）調用實例方法： + +```swift + let counter = Counter() + // 初始計數值是0 + counter.increment() + // 計數值現在是1 + counter.incrementBy(5) + // 計數值現在是6 + counter.reset() + // 計數值現在是0 +``` + + +### 方法的局部參數名稱和外部參數名稱(Local and External Parameter Names for Methods) + +函數參數可以同時有一個局部名稱（在函數體內部使用）和一個外部名稱（在調用函數時使用），詳情參見[函數的外部參數名](06_Functions.html)。方法參數也一樣（因為方法就是函數，只是這個函數與某個類型相關聯了）。但是，方法和函數的局部名稱和外部名稱的默認行為是不一樣的。 + +Swift 中的方法和 Objective-C 中的方法極其相似。像在 Objective-C 中一樣，Swift 中方法的名稱通常用一個介詞指向方法的第一個參數，比如：`with`，`for`，`by`等等。前面的`Counter`類的例子中`incrementBy`方法就是這樣的。介詞的使用讓方法在被調用時能像一個句子一樣被解讀。和函數參數不同，對於方法的參數，Swift 使用不同的默認處理方式，這可以讓方法命名規範更容易寫。 + +具體來說，Swift 默認僅給方法的第一個參數名稱一個局部參數名稱;默認同時給第二個和後續的參數名稱局部參數名稱和外部參數名稱。這個約定與典型的命名和調用約定相適應，與你在寫 Objective-C 的方法時很相似。這個約定還讓表達式方法在調用時不需要再限定參數名稱。 + +看看下面這個`Counter`的另一個版本（它定義了一個更複雜的`incrementBy`方法）： + +```swift +class Counter { + var count: Int = 0 + func incrementBy(amount: Int, numberOfTimes: Int) { + count += amount * numberOfTimes + } +} +``` + +`incrementBy`方法有兩個參數： `amount`和`numberOfTimes`。默認情況下，Swift 只把`amount`當作一個局部名稱，但是把`numberOfTimes`即看作局部名稱又看作外部名稱。下面調用這個方法： + +```swift +let counter = Counter() +counter.incrementBy(5, numberOfTimes: 3) +// counter value is now 15 +``` + +你不必為第一個參數值再定義一個外部變量名：因為從函數名`incrementBy`已經能很清楚地看出它的作用。但是第二個參數，就要被一個外部參數名稱所限定，以便在方法被調用時明確它的作用。 + +這種默認的行為能夠有效的處理方法（method）,類似於在參數`numberOfTimes`前寫一個井號（`#`）： + +```swift +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`方法還可以這樣寫： + +```swift +func increment() { + self.count++ +} +``` + +實際上，你不必在你的代碼裡面經常寫`self`。不論何時，只要在一個方法中使用一個已知的屬性或者方法名稱，如果你沒有明確的寫`self`，Swift 假定你是指當前實例的屬性或者方法。這種假定在上面的`Counter`中已經示範了：`Counter`中的三個實例方法中都使用的是`count`（而不是`self.count`）。 + +使用這條規則的主要場景是實例方法的某個參數名稱與實例的某個屬性名稱相同的時候。在這種情況下，參數名稱享有優先權，並且在引用屬性時必須使用一種更嚴格的方式。這時你可以使用`self`屬性來區分參數名稱和屬性名稱。 + +下面的例子中，`self`消除方法參數`x`和實例屬性`x`之間的歧義： + +```swift +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`關鍵字之前就可以了： + +```swift +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`關鍵字,這才讓方法可以修改值類型的屬性。 + +注意：不能在結構體類型常量上調用變異方法，因為常量的屬性不能被改變，即使想改變的是常量的變量屬性也不行，詳情參見[存儲屬性和實例變量]("10_Properties.html") + +```swift +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`的例子可以用下面的方式改寫： + +```swift +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`設置為相同的枚舉類型中不同的成員： + +```swift +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`類上調用類型方法的例子： + +```swift +class SomeClass { + class func someTypeMethod() { + // type method implementation goes here + } +} +SomeClass.someTypeMethod() +``` + +在類型方法的方法體（body）中，`self`指向這個類型本身，而不是類型的某個實例。對於結構體和枚舉來說，這意味著你可以用`self`來消除靜態屬性和靜態方法參數之間的歧義（類似於我們在前面處理實例屬性和實例方法參數時做的那樣）。 + +一般來說，任何未限定的方法和屬性名稱，將會來自於本類中另外的類型級別的方法和屬性。一個類型方法可以調用本類中另一個類型方法的名稱，而無需在方法名稱前面加上類型名稱的前綴。同樣，結構體和枚舉的類型方法也能夠直接通過靜態屬性的名稱訪問靜態屬性，而不需要類型名稱前綴。 + +下面的例子定義了一個名為`LevelTracker`結構體。它監測玩家的遊戲發展情況（遊戲的不同層次或階段）。這是一個單人遊戲，但也可以存儲多個玩家在同一設備上的遊戲信息。 + +遊戲初始時，所有的遊戲等級（除了等級 1）都被鎖定。每次有玩家完成一個等級，這個等級就對這個設備上的所有玩家解鎖。`LevelTracker`結構體用靜態屬性和方法監測遊戲的哪個等級已經被解鎖。它還監測每個玩家的當前等級。 + +```swift +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`來監測和更新每個玩家的發展進度： + +```swift +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`的實例，然後看這個玩家完成等級一時發生了什麼： + +```swift +var player = Player(name: "Argyrios") +player.completedLevel(1) +println("highest unlocked level is now \(LevelTracker.highestUnlockedLevel)") +// 輸出 "highest unlocked level is now 2"（最高等級現在是2） +``` + +如果你創建了第二個玩家，並嘗試讓它開始一個沒有被任何玩家解鎖的等級，那麼這次設置玩家當前等級的嘗試將會失敗： + +```swift +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還沒被解鎖） +``` diff --git a/source-tw/chapter2/12_Subscripts.md b/source-tw/chapter2/12_Subscripts.md new file mode 100644 index 00000000..16a66470 --- /dev/null +++ b/source-tw/chapter2/12_Subscripts.md @@ -0,0 +1,167 @@ +> 翻譯：[siemenliu](https://github.com/siemenliu) +> 校對：[zq54zquan](https://github.com/zq54zquan) + + +# 下標腳本（Subscripts） +----------------- + +本頁包含內容： + +- [下標腳本語法](#subscript_syntax) +- [下標腳本用法](#subscript_usage) +- [下標腳本選項](#subscript_options) + +*下標腳本* 可以定義在類（Class）、結構體（structure）和枚舉（enumeration）這些目標中，可以認為是訪問對像、集合或序列的快捷方式，不需要再調用實例的特定的賦值和訪問方法。舉例來說，用下標腳本訪問一個數組(Array)實例中的元素可以這樣寫 `someArray[index]` ，訪問字典(Dictionary)實例中的元素可以這樣寫 `someDictionary[key]`。 + +對於同一個目標可以定義多個下標腳本，通過索引值類型的不同來進行重載，而且索引值的個數可以是多個。 + +> 譯者：這裡附屬腳本重載在本小節中原文並沒有任何演示 + + +## 下標腳本語法 + +下標腳本允許你通過在實例後面的方括號中傳入一個或者多個的索引值來對實例進行訪問和賦值。語法類似於實例方法和計算型屬性的混合。與定義實例方法類似，定義下標腳本使用`subscript`關鍵字，顯式聲明入參（一個或多個）和返回類型。與實例方法不同的是下標腳本可以設定為讀寫或只讀。這種方式又有點像計算型屬性的getter和setter： + +```swift +subscript(index: Int) -> Int { + get { + // 返回與入參匹配的Int類型的值 + } + + set(newValue) { + // 執行賦值操作 + } +} +``` + +`newValue`的類型必須和下標腳本定義的返回類型相同。與計算型屬性相同的是set的入參聲明`newValue`就算不寫，在set代碼塊中依然可以使用默認的`newValue`這個變量來訪問新賦的值。 + +與只讀計算型屬性一樣，可以直接將原本應該寫在`get`代碼塊中的代碼寫在`subscript`中： + +```swift +subscript(index: Int) -> Int { + // 返回與入參匹配的Int類型的值 +} +``` + +下面代碼演示了一個在`TimesTable`結構體中使用只讀下標腳本的用法，該結構體用來展示傳入整數的*n*倍。 + +```swift +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`結構體創建了一個用來表示索引值三倍的實例。數值`3`作為結構體`構造函數`入參初始化實例成員`multiplier`。 + +你可以通過下標腳本來得到結果，比如`threeTimesTable[6]`。這條語句訪問了`threeTimesTable`的第六個元素，返回`6`的`3`倍即`18`。 + +>注意： +> `TimesTable`例子是基於一個固定的數學公式。它並不適合開放寫權限來對`threeTimesTable[someIndex]`進行賦值操作，這也是為什麼附屬腳本只定義為只讀的原因。 + + +## 下標腳本用法 + +根據使用場景不同下標腳本也具有不同的含義。通常下標腳本是用來訪問集合（collection），列表（list）或序列（sequence）中元素的快捷方式。你可以在你自己特定的類或結構體中自由的實現下標腳本來提供合適的功能。 + +例如，Swift 的字典（Dictionary）實現了通過下標腳本來對其實例中存放的值進行存取操作。在下標腳本中使用和字典索引相同類型的值，並且把一個字典值類型的值賦值給這個下標腳本來為字典設值： + +```swift +var numberOfLegs = ["spider": 8, "ant": 6, "cat": 4] +numberOfLegs["bird"] = 2 +``` + +上例定義一個名為`numberOfLegs`的變量並用一個字典字面量初始化出了包含三對鍵值的字典實例。`numberOfLegs`的字典存放值類型推斷為`Dictionary`。字典實例創建完成之後通過下標腳本的方式將整型值`2`賦值到字典實例的索引為`bird`的位置中。 + +更多關於字典（Dictionary）下標腳本的信息請參考[讀取和修改字典](../chapter2/04_Collection_Types.html) + +> 注意： +> Swift 中字典的附屬腳本實現中，在`get`部分返回值是`Int?`，上例中的`numberOfLegs`字典通過附屬腳本返回的是一個`Int?`或者說「可選的int」，不是每個字典的索引都能得到一個整型值，對於沒有設過值的索引的訪問返回的結果就是`nil`；同樣想要從字典實例中刪除某個索引下的值也只需要給這個索引賦值為`nil`即可。 + + +## 下標腳本選項 + +下標腳本允許任意數量的入參索引，並且每個入參類型也沒有限制。下標腳本的返回值也可以是任何類型。下標腳本可以使用變量參數和可變參數，但使用寫入讀出（in-out）參數或給參數設置默認值都是不允許的。 + +一個類或結構體可以根據自身需要提供多個下標腳本實現，在定義下標腳本時通過入參個類型進行區分，使用下標腳本時會自動匹配合適的下標腳本實現運行，這就是*下標腳本的重載*。 + +一個下標腳本入參是最常見的情況，但只要有合適的場景也可以定義多個下標腳本入參。如下例定義了一個`Matrix`結構體，將呈現一個`Double`類型的二維矩陣。`Matrix`結構體的下標腳本需要兩個整型參數： + +```swift +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) + columns] = newValue + } + } +} +``` + +`Matrix`提供了一個兩個入參的構造方法，入參分別是`rows`和`columns`，創建了一個足夠容納`rows * columns`個數的`Double`類型數組。為了存儲，將數組的大小和數組每個元素初始值0.0，都傳入數組的構造方法中來創建一個正確大小的新數組。關於數組的構造方法和析構方法請參考[創建並且構造一個數組](../chapter2/04_Collection_Types.html)。 + +你可以通過傳入合適的`row`和`column`的數量來構造一個新的`Matrix`實例： + +```swift +var matrix = Matrix(rows: 2, columns: 2) +``` + +上例中創建了一個新的兩行兩列的`Matrix`實例。在閱讀順序從左上到右下的`Matrix`實例中的數組實例`grid`是矩陣二維數組的扁平化存儲： + +```swift +// 示意圖 +grid = [0.0, 0.0, 0.0, 0.0] + + col0 col1 +row0 [0.0, 0.0, +row1 0.0, 0.0] +``` + +將值賦給帶有`row`和`column`下標腳本的`matrix`實例表達式可以完成賦值操作，下標腳本入參使用逗號分割 + +```swift +matrix[0, 1] = 1.5 +matrix[1, 0] = 3.2 +``` + +上面兩條語句分別`讓matrix`的右上值為 1.5，坐下值為 3.2： + +```swift +[0.0, 1.5, + 3.2, 0.0] +``` + +`Matrix`下標腳本的`getter`和`setter`中同時調用了下標腳本入參的`row`和`column`是否有效的判斷。為了方便進行斷言，`Matrix`包含了一個名為`indexIsValid`的成員方法，用來確認入參的`row`或`column`值是否會造成數組越界： + +```swift +func indexIsValidForRow(row: Int, column: Int) -> Bool { + return row >= 0 && row < rows && column >= 0 && column < columns +} +``` + +斷言在下標腳本越界時觸發： + +```swift +let someValue = matrix[2, 2] +// 斷言將會觸發，因為 [2, 2] 已經超過了matrix的最大長度 +``` diff --git a/source-tw/chapter2/13_Inheritance.md b/source-tw/chapter2/13_Inheritance.md new file mode 100644 index 00000000..2a4fe7ee --- /dev/null +++ b/source-tw/chapter2/13_Inheritance.md @@ -0,0 +1,270 @@ +> 翻譯：[Hawstein](https://github.com/Hawstein) +> 校對：[menlongsheng](https://github.com/menlongsheng) + +# 繼承（Inheritance） +------------------- + +本頁包含內容： + +- [定義一個基類（Base class）](#defining_a_base_class) +- [子類生成（Subclassing）](#subclassing) +- [重寫（Overriding）](#overriding) +- [防止重寫](#preventing_overrides) + +一個類可以*繼承（inherit）*另一個類的方法（methods），屬性（property）和其它特性。當一個類繼承其它類時，繼承類叫*子類（subclass）*，被繼承類叫*超類（或父類，superclass）*。在 Swift 中，繼承是區分「類」與其它類型的一個基本特徵。 + +在 Swift 中，類可以調用和訪問超類的方法，屬性和下標腳本（subscripts），並且可以重寫（override）這些方法，屬性和下標腳本來優化或修改它們的行為。Swift 會檢查你的重寫定義在超類中是否有匹配的定義，以此確保你的重寫行為是正確的。 + +可以為類中繼承來的屬性添加屬性觀察器（property observer），這樣一來，當屬性值改變時，類就會被通知到。可以為任何屬性添加屬性觀察器，無論它原本被定義為存儲型屬性（stored property）還是計算型屬性（computed property）。 + + +## 定義一個基類（Base class） + +不繼承於其它類的類，稱之為*基類（base calss）*。 + +> 注意： +Swift 中的類並不是從一個通用的基類繼承而來。如果你不為你定義的類指定一個超類的話，這個類就自動成為基類。 + +下面的例子定義了一個叫`Vehicle`的基類。這個基類聲明了兩個對所有車輛都通用的屬性（`numberOfWheels`和`maxPassengers`）。這些屬性在`description`方法中使用，這個方法返回一個`String`類型的，對車輛特徵的描述： + +```swift +class Vehicle { + var numberOfWheels: Int + var maxPassengers: Int + func description() -> String { + return "\(numberOfWheels) wheels; up to \(maxPassengers) passengers" + } + init() { + numberOfWheels = 0 + maxPassengers = 1 + } +} +``` + +`Vehicle`類定義了*構造器（initializer）*來設置屬性的值。構造器會在[構造過程](../chapter2/_14Initialization.html)一節中詳細介紹，這裡我們做一下簡單介紹，以便於講解子類中繼承來的屬性如何被修改。 + +構造器用於創建某個類型的一個新實例。儘管構造器並不是方法，但在語法上，兩者很相似。構造器的工作是準備新實例以供使用，並確保實例中的所有屬性都擁有有效的初始化值。 + +構造器的最簡單形式就像一個沒有參數的實例方法，使用`init`關鍵字： + +```swift +init() { + // 執行構造過程 +} +``` + +如果要創建一個`Vehicle`類的新實例，使用*構造器*語法調用上面的初始化器，即類名後面跟一個空的小括號： + +```swift +let someVehicle = Vehicle() +``` + +這個`Vehicle`類的構造器為任意的一輛車設置一些初始化屬性值（`numberOfWheels = 0 `和`maxPassengers = 1`）。 + +`Vehicle`類定義了車輛的共同特性，但這個類本身並沒太大用處。為了使它更為實用，你需要進一步細化它來描述更具體的車輛。 + + +## 子類生成（Subclassing） + +*子類生成（Subclassing）*指的是在一個已有類的基礎上創建一個新的類。子類繼承超類的特性，並且可以優化或改變它。你還可以為子類添加新的特性。 + +為了指明某個類的超類，將超類名寫在子類名的後面，用冒號分隔： + +```swift +class SomeClass: SomeSuperclass { + // 類的定義 +} +``` + +下一個例子，定義一個更具體的車輛類叫`Bicycle`。這個新類是在 `Vehicle`類的基礎上創建起來。因此你需要將`Vehicle`類放在 `Bicycle`類後面，用冒號分隔。 + +我們可以將這讀作： + +「定義一個新的類叫`Bicycle `，它繼承了`Vehicle`的特性」； + +```swift +class Bicycle: Vehicle { + init() { + super.init() + numberOfWheels = 2 + } +} +``` +preview + `Bicycle`是`Vehicle`的子類，`Vehicle`是`Bicycle`的超類。新的`Bicycle`類自動獲得`Vehicle`類的特性，比如 `maxPassengers`和`numberOfWheels`屬性。你可以在子類中定制這些特性，或添加新的特性來更好地描述`Bicycle`類。 + +`Bicycle`類定義了一個構造器來設置它定制的特性（自行車只有2個輪子）。`Bicycle`的構造器調用了它父類`Vehicle`的構造器 `super.init()`，以此確保在`Bicycle`類試圖修改那些繼承來的屬性前`Vehicle`類已經初始化過它們了。 + +> 注意： +不像 Objective-C，在 Swift 中，初始化器默認是不繼承的，見[初始化器的繼承與重寫](../chapter2/_14Initialization.html#initializer_inheritance_and_ overriding) + +`Vehicle`類中`maxPassengers`的默認值對自行車來說已經是正確的，因此在`Bicycle`的構造器中並沒有改變它。而`numberOfWheels`原來的值對自行車來說是不正確的，因此在初始化器中將它更改為 2。 + +`Bicycle`不僅可以繼承`Vehicle`的屬性，還可以繼承它的方法。如果你創建了一個`Bicycle`類的實例，你就可以調用它繼承來的`description`方法，並且可以看到，它輸出的屬性值已經發生了變化： + +```swift +let bicycle = Bicycle() +println("Bicycle: \(bicycle.description())") +// Bicycle: 2 wheels; up to 1 passengers +``` + +子類還可以繼續被其它類繼承： + +```swift +class Tandem: Bicycle { + init() { + super.init() + maxPassengers = 2 + } +} +``` + +上面的例子創建了`Bicycle`的一個子類：雙人自行車（tandem）。`Tandem`從`Bicycle`繼承了兩個屬性，而這兩個屬性是`Bicycle`從`Vehicle`繼承而來的。`Tandem`並不修改輪子的數量，因為它仍是一輛自行車，有 2 個輪子。但它需要修改`maxPassengers`的值，因為雙人自行車可以坐兩個人。 + +> 注意： +子類只允許修改從超類繼承來的變量屬性，而不能修改繼承來的常量屬性。 + +創建一個`Tandem`類的實例，打印它的描述，即可看到它的屬性已被更新： + +```swift +let tandem = Tandem() +println("Tandem: \(tandem.description())") +// Tandem: 2 wheels; up to 2 passengers +``` + +注意，`Tandem`類也繼承了`description`方法。一個類的實例方法會被這個類的所有子類繼承。 + + +## 重寫（Overriding） + +子類可以為繼承來的實例方法（instance method），類方法（class method），實例屬性（instance property），或下標腳本（subscript）提供自己定制的實現（implementation）。我們把這種行為叫*重寫（overriding）*。 + +如果要重寫某個特性，你需要在重寫定義的前面加上`override`關鍵字。這麼做，你就表明了你是想提供一個重寫版本，而非錯誤地提供了一個相同的定義。意外的重寫行為可能會導致不可預知的錯誤，任何缺少`override`關鍵字的重寫都會在編譯時被診斷為錯誤。 + +`override`關鍵字會提醒 Swift 編譯器去檢查該類的超類（或其中一個父類）是否有匹配重寫版本的聲明。這個檢查可以確保你的重寫定義是正確的。 + +### 訪問超類的方法，屬性及下標腳本 + +當你在子類中重寫超類的方法，屬性或下標腳本時，有時在你的重寫版本中使用已經存在的超類實現會大有裨益。比如，你可以優化已有實現的行為，或在一個繼承來的變量中存儲一個修改過的值。 + +在合適的地方，你可以通過使用`super`前綴來訪問超類版本的方法，屬性或下標腳本： + +* 在方法`someMethod`的重寫實現中，可以通過`super.someMethod()`來調用超類版本的`someMethod`方法。 +* 在屬性`someProperty`的 getter 或 setter 的重寫實現中，可以通過`super.someProperty`來訪問超類版本的`someProperty`屬性。 +* 在下標腳本的重寫實現中，可以通過`super[someIndex]`來訪問超類版本中的相同下標腳本。 + +### 重寫方法 + +在子類中，你可以重寫繼承來的實例方法或類方法，提供一個定制或替代的方法實現。 + +下面的例子定義了`Vehicle`的一個新的子類，叫`Car`，它重寫了從`Vehicle`類繼承來的`description`方法： + +```swift +class Car: Vehicle { + var speed: Double = 0.0 + init() { + super.init() + maxPassengers = 5 + numberOfWheels = 4 + } + override func description() -> String { + return super.description() + "; " + + "traveling at \(speed) mph" + } +} +``` + +`Car`聲明了一個新的存儲型屬性`speed`，它是`Double`類型的，默認值是`0.0`，表示「時速是0英里」。`Car`有自己的初始化器，它將乘客的最大數量設為5，輪子數量設為4。 + +`Car`重寫了繼承來的`description`方法，它的聲明與`Vehicle`中的`description`方法一致，聲明前面加上了`override`關鍵字。 + +`Car`中的`description`方法並非完全自定義，而是通過`super.description`使用了超類`Vehicle`中的`description`方法，然後再追加一些額外的信息，比如汽車的當前速度。 + +如果你創建一個`Car`的新實例，並打印`description`方法的輸出，你就會發現描述信息已經發生了改變： + +```swift +let car = Car() +println("Car: \(car.description())") +// Car: 4 wheels; up to 5 passengers; traveling at 0.0 mph +``` + +### 重寫屬性 + +你可以重寫繼承來的實例屬性或類屬性，提供自己定制的getter和setter，或添加屬性觀察器使重寫的屬性觀察屬性值什麼時候發生改變。 + +#### 重寫屬性的Getters和Setters + +你可以提供定制的 getter（或 setter）來重寫任意繼承來的屬性，無論繼承來的屬性是存儲型的還是計算型的屬性。子類並不知道繼承來的屬性是存儲型的還是計算型的，它只知道繼承來的屬性會有一個名字和類型。你在重寫一個屬性時，必需將它的名字和類型都寫出來。這樣才能使編譯器去檢查你重寫的屬性是與超類中同名同類型的屬性相匹配的。 + +你可以將一個繼承來的只讀屬性重寫為一個讀寫屬性，只需要你在重寫版本的屬性裡提供 getter 和 setter 即可。但是，你不可以將一個繼承來的讀寫屬性重寫為一個只讀屬性。 + +> 注意： +如果你在重寫屬性中提供了 setter，那麼你也一定要提供 getter。如果你不想在重寫版本中的 getter 裡修改繼承來的屬性值，你可以直接返回`super.someProperty`來返回繼承來的值。正如下面的`SpeedLimitedCar`的例子所示。 + +以下的例子定義了一個新類，叫`SpeedLimitedCar`，它是`Car`的子類。類`SpeedLimitedCar`表示安裝了限速裝置的車，它的最高速度只能達到40mph。你可以通過重寫繼承來的`speed`屬性來實現這個速度限制： + +```swift +class SpeedLimitedCar: Car { + override var speed: Double { + get { + return super.speed + } + set { + super.speed = min(newValue, 40.0) + } + } +} +``` + +當你設置一個`SpeedLimitedCar`實例的`speed`屬性時，屬性setter的實現會去檢查新值與限制值40mph的大小，它會將超類的`speed`設置為`newValue`和`40.0`中較小的那個。這兩個值哪個較小由`min`函數決定，它是Swift標準庫中的一個全局函數。`min`函數接收兩個或更多的數，返回其中最小的那個。 + +如果你嘗試將`SpeedLimitedCar`實例的`speed`屬性設置為一個大於40mph的數，然後打印`description`函數的輸出，你會發現速度被限制在40mph： + +```swift +let limitedCar = SpeedLimitedCar() +limitedCar.speed = 60.0 +println("SpeedLimitedCar: \(limitedCar.description())") +// SpeedLimitedCar: 4 wheels; up to 5 passengers; traveling at 40.0 mph +``` + +#### 重寫屬性觀察器（Property Observer） + +你可以在屬性重寫中為一個繼承來的屬性添加屬性觀察器。這樣一來，當繼承來的屬性值發生改變時，你就會被通知到，無論那個屬性原本是如何實現的。關於屬性觀察器的更多內容，請看[屬性觀察器](../chapter2/_10Properties.html#property_observer)。 + +> 注意： +你不可以為繼承來的常量存儲型屬性或繼承來的只讀計算型屬性添加屬性觀察器。這些屬性的值是不可以被設置的，所以，為它們提供`willSet`或`didSet`實現是不恰當。此外還要注意，你不可以同時提供重寫的 setter 和重寫的屬性觀察器。如果你想觀察屬性值的變化，並且你已經為那個屬性提供了定制的 setter，那麼你在 setter 中就可以觀察到任何值變化了。 + +下面的例子定義了一個新類叫`AutomaticCar`，它是`Car`的子類。`AutomaticCar`表示自動擋汽車，它可以根據當前的速度自動選擇合適的擋位。`AutomaticCar`也提供了定制的`description`方法，可以輸出當前擋位。 + +```swift +class AutomaticCar: Car { + var gear = 1 + override var speed: Double { + didSet { + gear = Int(speed / 10.0) + 1 + } + } + override func description() -> String { + return super.description() + " in gear \(gear)" + } +} +``` + +當你設置`AutomaticCar`的`speed`屬性，屬性的`didSet`觀察器就會自動地設置`gear`屬性，為新的速度選擇一個合適的擋位。具體來說就是，屬性觀察器將新的速度值除以10，然後向下取得最接近的整數值，最後加1來得到檔位`gear`的值。例如，速度為10.0時，擋位為1；速度為35.0時，擋位為4： + +```swift +let automatic = AutomaticCar() +automatic.speed = 35.0 +println("AutomaticCar: \(automatic.description())") +// AutomaticCar: 4 wheels; up to 5 passengers; traveling at 35.0 mph in gear 4 +``` + + +## 防止重寫 + +你可以通過把方法，屬性或下標腳本標記為*`final`*來防止它們被重寫，只需要在聲明關鍵字前加上`@final`特性即可。（例如：`@final var`, `@final func`, `@final class func`, 以及 `@final subscript`） + +如果你重寫了`final`方法，屬性或下標腳本，在編譯時會報錯。在擴展中，你添加到類裡的方法，屬性或下標腳本也可以在擴展的定義裡標記為 final。 + +你可以通過在關鍵字`class`前添加`@final`特性（`@final class`）來將整個類標記為 final 的，這樣的類是不可被繼承的，否則會報編譯錯誤。 + diff --git a/source-tw/chapter2/14_Initialization.md b/source-tw/chapter2/14_Initialization.md new file mode 100644 index 00000000..7fd17ecc --- /dev/null +++ b/source-tw/chapter2/14_Initialization.md @@ -0,0 +1,646 @@ +> 翻譯：[lifedim](https://github.com/lifedim) +> 校對：[lifedim](https://github.com/lifedim) + +# 構造過程（Initialization） + +----------------- + +本頁包含內容： + +- [存儲型屬性的初始賦值](#setting_initial_values_for_stored_properties) +- [定制化構造過程](#customizing_initialization) +- [默認構造器](#default_initializers) +- [值類型的構造器代理](#initializer_delegation_for_value_types) +- [類的繼承和構造過程](#class_inheritance_and_initialization) +- [通過閉包和函數來設置屬性的默認值](#setting_a_default_property_value_with_a_closure_or_function) + + +構造過程是為了使用某個類、結構體或枚舉類型的實例而進行的準備過程。這個過程包含了為實例中的每個屬性設置初始值和為其執行必要的準備和初始化任務。 + +構造過程是通過定義構造器（`Initializers`）來實現的，這些構造器可以看做是用來創建特定類型實例的特殊方法。與 Objective-C 中的構造器不同，Swift 的構造器無需返回值，它們的主要任務是保證新實例在第一次使用前完成正確的初始化。 + +類實例也可以通過定義析構器（`deinitializer`）在類實例釋放之前執行特定的清除工作。想瞭解更多關於析構器的內容，請參考[析構過程](../chapter2/15_Deinitialization.html)。 + + +## 存儲型屬性的初始賦值 + +類和結構體在實例創建時，必須為所有存儲型屬性設置合適的初始值。存儲型屬性的值不能處於一個未知的狀態。 + +你可以在構造器中為存儲型屬性賦初值，也可以在定義屬性時為其設置默認值。以下章節將詳細介紹這兩種方法。 + +>注意： +當你為存儲型屬性設置默認值或者在構造器中為其賦值時，它們的值是被直接設置的，不會觸發任何屬性觀測器（`property observers`）。 + +### 構造器 + +構造器在創建某特定類型的新實例時調用。它的最簡形式類似於一個不帶任何參數的實例方法，以關鍵字`init`命名。 + +下面例子中定義了一個用來保存華氏溫度的結構體`Fahrenheit`，它擁有一個`Double`類型的存儲型屬性`temperature`： + +```swift +struct Fahrenheit { + var temperature: Double + init() { + temperature = 32.0 + } +} +``` + +```swift +var f = Fahrenheit() +println("The default temperature is \(f.temperature)° Fahrenheit") +// 輸出 "The default temperature is 32.0° Fahrenheit」 +``` + +這個結構體定義了一個不帶參數的構造器`init`，並在裡面將存儲型屬性`temperature`的值初始化為`32.0`（華攝氏度下水的冰點）。 + +### 默認屬性值 + +如前所述，你可以在構造器中為存儲型屬性設置初始值；同樣，你也可以在屬性聲明時為其設置默認值。 + +>注意： +如果一個屬性總是使用同一個初始值，可以為其設置一個默認值。無論定義默認值還是在構造器中賦值，最終它們實現的效果是一樣的，只不過默認值跟屬性構造過程結合的更緊密。使用默認值能讓你的構造器更簡潔、更清晰，且能通過默認值自動推導出屬性的類型；同時，它也能讓你充分利用默認構造器、構造器繼承（後續章節將講到）等特性。 + +你可以使用更簡單的方式在定義結構體`Fahrenheit`時為屬性`temperature`設置默認值： + +```swift +struct Fahrenheit { + var temperature = 32.0 +} +``` + + +## 定制化構造過程 + +你可以通過輸入參數和可選屬性類型來定制構造過程，也可以在構造過程中修改常量屬性。這些都將在後面章節中提到。 + +### 構造參數 + +你可以在定義構造器時提供構造參數，為其提供定制化構造所需值的類型和名字。構造器參數的功能和語法跟函數和方法參數相同。 + +下面例子中定義了一個包含攝氏度溫度的結構體`Celsius`。它定義了兩個不同的構造器：`init(fromFahrenheit:)`和`init(fromKelvin:)`，二者分別通過接受不同刻度表示的溫度值來創建新的實例： + +```swift +struct Celsius { + var temperatureInCelsius: Double = 0.0 + init(fromFahrenheit fahrenheit: Double) { + temperatureInCelsius = (fahrenheit - 32.0) / 1.8 + } + init(fromKelvin kelvin: Double) { + temperatureInCelsius = kelvin - 273.15 + } +} +``` + +```swift +let boilingPointOfWater = Celsius(fromFahrenheit: 212.0) +// boilingPointOfWater.temperatureInCelsius 是 100.0 +let freezingPointOfWater = Celsius(fromKelvin: 273.15) +// freezingPointOfWater.temperatureInCelsius 是 0.0」 +``` + +第一個構造器擁有一個構造參數，其外部名字為`fromFahrenheit`，內部名字為`fahrenheit`；第二個構造器也擁有一個構造參數，其外部名字為`fromKelvin`，內部名字為`kelvin`。這兩個構造器都將唯一的參數值轉換成攝氏溫度值，並保存在屬性`temperatureInCelsius`中。 + +### 內部和外部參數名 + +跟函數和方法參數相同，構造參數也存在一個在構造器內部使用的參數名字和一個在調用構造器時使用的外部參數名字。 + +然而，構造器並不像函數和方法那樣在括號前有一個可辨別的名字。所以在調用構造器時，主要通過構造器中的參數名和類型來確定需要調用的構造器。正因為參數如此重要，如果你在定義構造器時沒有提供參數的外部名字，Swift 會為每個構造器的參數自動生成一個跟內部名字相同的外部名，就相當於在每個構造參數之前加了一個哈希符號。 + +> 注意： +如果你不希望為構造器的某個參數提供外部名字，你可以使用下劃線`_`來顯示描述它的外部名，以此覆蓋上面所說的默認行為。 + +以下例子中定義了一個結構體`Color`，它包含了三個常量：`red`、`green`和`blue`。這些屬性可以存儲0.0到1.0之間的值，用來指示顏色中紅、綠、藍成分的含量。 + +`Color`提供了一個構造器，其中包含三個`Double`類型的構造參數： + +```swift +struct Color { + let red = 0.0, green = 0.0, blue = 0.0 + init(red: Double, green: Double, blue: Double) { + self.red = red + self.green = green + self.blue = blue + } +} +``` + +每當你創建一個新的`Color`實例，你都需要通過三種顏色的外部參數名來傳值，並調用構造器。 + +```swift +let magenta = Color(red: 1.0, green: 0.0, blue: 1.0) +``` + +注意，如果不通過外部參數名字傳值，你是沒法調用這個構造器的。只要構造器定義了某個外部參數名，你就必須使用它，忽略它將導致編譯錯誤： + +```swift +let veryGreen = Color(0.0, 1.0, 0.0) +// 報編譯時錯誤，需要外部名稱 +``` + +### 可選屬性類型 + +如果你定制的類型包含一個邏輯上允許取值為空的存儲型屬性--不管是因為它無法在初始化時賦值，還是因為它可以在之後某個時間點可以賦值為空--你都需要將它定義為可選類型`optional type`。可選類型的屬性將自動初始化為空`nil`，表示這個屬性是故意在初始化時設置為空的。 + +下面例子中定義了類`SurveyQuestion`，它包含一個可選字符串屬性`response`： + +```swift +class SurveyQuestion { + var text: String + var response: String? + init(text: String) { + self.text = text + } + func ask() { + println(text) + } +} +let cheeseQuestion = SurveyQuestion(text: "Do you like cheese?") +cheeseQuestion.ask() +// 輸出 "Do you like cheese?" +cheeseQuestion.response = "Yes, I do like cheese. +``` + +調查問題在問題提出之後，我們才能得到回答。所以我們將屬性回答`response`聲明為`String?`類型，或者說是可選字符串類型`optional String`。當`SurveyQuestion`實例化時，它將自動賦值為空`nil`，表明暫時還不存在此字符串。 + +### 構造過程中常量屬性的修改 + +只要在構造過程結束前常量的值能確定，你可以在構造過程中的任意時間點修改常量屬性的值。 + +>注意： +對某個類實例來說，它的常量屬性只能在定義它的類的構造過程中修改；不能在子類中修改。 + +你可以修改上面的`SurveyQuestion`示例，用常量屬性替代變量屬性`text`，指明問題內容`text`在其創建之後不會再被修改。儘管`text`屬性現在是常量，我們仍然可以在其類的構造器中設置它的值： + +```swift +class SurveyQuestion { + let text: String + var response: String? + init(text: String) { + self.text = text + } + func ask() { + println(text) + } +} +let beetsQuestion = SurveyQuestion(text: "How about beets?") +beetsQuestion.ask() +// 輸出 "How about beets?" +beetsQuestion.response = "I also like beets. (But not with cheese.) +``` + + +## 默認構造器 + +Swift 將為所有屬性已提供默認值的且自身沒有定義任何構造器的結構體或基類，提供一個默認的構造器。這個默認構造器將簡單的創建一個所有屬性值都設置為默認值的實例。 + +下面例子中創建了一個類`ShoppingListItem`，它封裝了購物清單中的某一項的屬性：名字（`name`）、數量（`quantity`）和購買狀態 `purchase state`。 + +```swift +class ShoppingListItem { + var name: String? + var quantity = 1 + var purchased = false +} +var item = ShoppingListItem() +``` + +由於`ShoppingListItem`類中的所有屬性都有默認值，且它是沒有父類的基類，它將自動獲得一個可以為所有屬性設置默認值的默認構造器（儘管代碼中沒有顯式為`name`屬性設置默認值，但由於`name`是可選字符串類型，它將默認設置為`nil`）。上面例子中使用默認構造器創造了一個`ShoppingListItem`類的實例（使用`ShoppingListItem()`形式的構造器語法），並將其賦值給變量`item`。 + +### 結構體的逐一成員構造器 + +除上面提到的默認構造器，如果結構體對所有存儲型屬性提供了默認值且自身沒有提供定制的構造器，它們能自動獲得一個逐一成員構造器。 + +逐一成員構造器是用來初始化結構體新實例裡成員屬性的快捷方法。我們在調用逐一成員構造器時，通過與成員屬性名相同的參數名進行傳值來完成對成員屬性的初始賦值。 + +下面例子中定義了一個結構體`Size`，它包含兩個屬性`width`和`height`。Swift 可以根據這兩個屬性的初始賦值`0.0`自動推導出它們的類型`Double`。 + +由於這兩個存儲型屬性都有默認值，結構體`Size`自動獲得了一個逐一成員構造器 `init(width:height:)`。 你可以用它來為`Size`創建新的實例： + +```swift +struct Size { + var width = 0.0, height = 0.0 +} +let twoByTwo = Size(width: 2.0, height: 2.0) +``` + + +## 值類型的構造器代理 + +構造器可以通過調用其它構造器來完成實例的部分構造過程。這一過程稱為構造器代理，它能減少多個構造器間的代碼重複。 + +構造器代理的實現規則和形式在值類型和類類型中有所不同。值類型（結構體和枚舉類型）不支持繼承，所以構造器代理的過程相對簡單，因為它們只能代理給本身提供的其它構造器。類則不同，它可以繼承自其它類（請參考[繼承](../chapter2/13_Inheritance.html)），這意味著類有責任保證其所有繼承的存儲型屬性在構造時也能正確的初始化。這些責任將在後續章節[類的繼承和構造過程](#class_inheritance_and_initialization)中介紹。 + +對於值類型，你可以使用`self.init`在自定義的構造器中引用其它的屬於相同值類型的構造器。並且你只能在構造器內部調用`self.init`。 + +注意，如果你為某個值類型定義了一個定制的構造器，你將無法訪問到默認構造器（如果是結構體，則無法訪問逐一對像構造器）。這個限制可以防止你在為值類型定義了一個更複雜的，完成了重要準備構造器之後，別人還是錯誤的使用了那個自動生成的構造器。 + +>注意： +假如你想通過默認構造器、逐一對像構造器以及你自己定制的構造器為值類型創建實例，我們建議你將自己定制的構造器寫到擴展（`extension`）中，而不是跟值類型定義混在一起。想查看更多內容，請查看[擴展](../chapter2/20_Extensions.html)章節。 + +下面例子將定義一個結構體`Rect`，用來代表幾何矩形。這個例子需要兩個輔助的結構體`Size`和`Point`，它們各自為其所有的屬性提供了初始值`0.0`。 + +```swift +struct Size { + var width = 0.0, height = 0.0 +} +struct Point { + var x = 0.0, y = 0.0 +} +``` + +你可以通過以下三種方式為`Rect`創建實例--使用默認的0值來初始化`origin`和`size`屬性；使用特定的`origin`和`size`實例來初始化；使用特定的`center`和`size`來初始化。在下面`Rect`結構體定義中，我們為這三種方式提供了三個自定義的構造器： + +```swift +struct Rect { + var origin = Point() + var size = Size() + init() {} + init(origin: Point, size: Size) { + self.origin = origin + self.size = size + } + init(center: Point, size: Size) { + let originX = center.x - (size.width / 2) + let originY = center.y - (size.height / 2) + self.init(origin: Point(x: originX, y: originY), size: size) + } +} +``` + +第一個`Rect`構造器`init()`，在功能上跟沒有自定義構造器時自動獲得的默認構造器是一樣的。這個構造器是一個空函數，使用一對大括號`{}`來描述，它沒有執行任何定制的構造過程。調用這個構造器將返回一個`Rect`實例，它的`origin`和`size`屬性都使用定義時的默認值`Point(x: 0.0, y: 0.0)`和`Size(width: 0.0, height: 0.0)`： + +```swift +let basicRect = Rect() +// basicRect 的原點是 (0.0, 0.0)，尺寸是 (0.0, 0.0) +``` + +第二個`Rect`構造器`init(origin:size:)`，在功能上跟結構體在沒有自定義構造器時獲得的逐一成員構造器是一樣的。這個構造器只是簡單地將`origin`和`size`的參數值賦給對應的存儲型屬性： + +```swift +let originRect = Rect(origin: Point(x: 2.0, y: 2.0), + size: Size(width: 5.0, height: 5.0)) +// originRect 的原點是 (2.0, 2.0)，尺寸是 (5.0, 5.0) +``` + +第三個`Rect`構造器`init(center:size:)`稍微複雜一點。它先通過`center`和`size`的值計算出`origin`的坐標。然後再調用（或代理給）`init(origin:size:)`構造器來將新的`origin`和`size`值賦值到對應的屬性中： + +```swift +let centerRect = Rect(center: Point(x: 4.0, y: 4.0), + size: Size(width: 3.0, height: 3.0)) +// centerRect 的原點是 (2.5, 2.5)，尺寸是 (3.0, 3.0) +``` + +構造器`init(center:size:)`可以自己將`origin`和`size`的新值賦值到對應的屬性中。然而盡量利用現有的構造器和它所提供的功能來實現`init(center:size:)`的功能，是更方便、更清晰和更直觀的方法。 + +>注意： +如果你想用另外一種不需要自己定義`init()`和`init(origin:size:)`的方式來實現這個例子，請參考[擴展](../chapter2/20_Extensions.html)。 + + +## 類的繼承和構造過程 + +類裡面的所有存儲型屬性--包括所有繼承自父類的屬性--都必須在構造過程中設置初始值。 + +Swift 提供了兩種類型的類構造器來確保所有類實例中存儲型屬性都能獲得初始值，它們分別是指定構造器和便利構造器。 + +### 指定構造器和便利構造器 + +指定構造器是類中最主要的構造器。一個指定構造器將初始化類中提供的所有屬性，並根據父類鏈往上調用父類的構造器來實現父類的初始化。 + +每一個類都必須擁有至少一個指定構造器。在某些情況下，許多類通過繼承了父類中的指定構造器而滿足了這個條件。具體內容請參考後續章節[自動構造器的繼承](#automatic_initializer_inheritance)。 + +便利構造器是類中比較次要的、輔助型的構造器。你可以定義便利構造器來調用同一個類中的指定構造器，並為其參數提供默認值。你也可以定義便利構造器來創建一個特殊用途或特定輸入的實例。 + +你應當只在必要的時候為類提供便利構造器，比方說某種情況下通過使用便利構造器來快捷調用某個指定構造器，能夠節省更多開發時間並讓類的構造過程更清晰明瞭。 + + +### 構造器鏈 + +為了簡化指定構造器和便利構造器之間的調用關係，Swift 採用以下三條規則來限制構造器之間的代理調用： + +#### 規則 1 +指定構造器必須調用其直接父類的的指定構造器。 + +#### 規則 2 +便利構造器必須調用同一類中定義的其它構造器。 + +#### 規則 3 +便利構造器必須最終以調用一個指定構造器結束。 + +一個更方便記憶的方法是： + +- 指定構造器必須總是向上代理 +- 便利構造器必須總是橫向代理 + +這些規則可以通過下面圖例來說明： + +![構造器代理圖](https://developer.apple.com/library/prerelease/ios/documentation/swift/conceptual/swift_programming_language/Art/initializerDelegation01_2x.png) + +如圖所示，父類中包含一個指定構造器和兩個便利構造器。其中一個便利構造器調用了另外一個便利構造器，而後者又調用了唯一的指定構造器。這滿足了上面提到的規則2和3。這個父類沒有自己的父類，所以規則1沒有用到。 + +子類中包含兩個指定構造器和一個便利構造器。便利構造器必須調用兩個指定構造器中的任意一個，因為它只能調用同一個類裡的其他構造器。這滿足了上面提到的規則2和3。而兩個指定構造器必須調用父類中唯一的指定構造器，這滿足了規則1。 + +> 注意： +這些規則不會影響使用時，如何用類去創建實例。任何上圖中展示的構造器都可以用來完整創建對應類的實例。這些規則只在實現類的定義時有影響。 + +下面圖例中展示了一種針對四個類的更複雜的類層級結構。它演示了指定構造器是如何在類層級中充當「管道」的作用，在類的構造器鏈上簡化了類之間的相互關係。 + +![複雜構造器代理圖](https://developer.apple.com/library/prerelease/ios/documentation/swift/conceptual/swift_programming_language/Art/initializerDelegation02_2x.png) + + +### 兩段式構造過程 + +Swift 中類的構造過程包含兩個階段。第一個階段，每個存儲型屬性通過引入它們的類的構造器來設置初始值。當每一個存儲型屬性值被確定後，第二階段開始，它給每個類一次機會在新實例準備使用之前進一步定制它們的存儲型屬性。 + +兩段式構造過程的使用讓構造過程更安全，同時在整個類層級結構中給予了每個類完全的靈活性。兩段式構造過程可以防止屬性值在初始化之前被訪問；也可以防止屬性被另外一個構造器意外地賦予不同的值。 + +> 注意： +Swift的兩段式構造過程跟 Objective-C 中的構造過程類似。最主要的區別在於階段 1，Objective-C 給每一個屬性賦值`0`或空值（比如說`0`或`nil`）。Swift 的構造流程則更加靈活，它允許你設置定制的初始值，並自如應對某些屬性不能以`0`或`nil`作為合法默認值的情況。 + +Swift 編譯器將執行 4 種有效的安全檢查，以確保兩段式構造過程能順利完成： + +#### 安全檢查 1 + +指定構造器必須保證它所在類引入的所有屬性都必須先初始化完成，之後才能將其它構造任務向上代理給父類中的構造器。 + +如上所述，一個對象的內存只有在其所有存儲型屬性確定之後才能完全初始化。為了滿足這一規則，指定構造器必須保證它所在類引入的屬性在它往上代理之前先完成初始化。 + +#### 安全檢查 2 + +指定構造器必須先向上代理調用父類構造器，然後再為繼承的屬性設置新值。如果沒這麼做，指定構造器賦予的新值將被父類中的構造器所覆蓋。 + +#### 安全檢查 3 + +便利構造器必須先代理調用同一類中的其它構造器，然後再為任意屬性賦新值。如果沒這麼做，便利構造器賦予的新值將被同一類中其它指定構造器所覆蓋。 + +#### 安全檢查 4 + +構造器在第一階段構造完成之前，不能調用任何實例方法、不能讀取任何實例屬性的值，也不能引用`self`的值。 + +以下是兩段式構造過程中基於上述安全檢查的構造流程展示： + +#### 階段 1 + +- 某個指定構造器或便利構造器被調用； +- 完成新實例內存的分配，但此時內存還沒有被初始化； +- 指定構造器確保其所在類引入的所有存儲型屬性都已賦初值。存儲型屬性所屬的內存完成初始化； +- 指定構造器將調用父類的構造器，完成父類屬性的初始化； +- 這個調用父類構造器的過程沿著構造器鏈一直往上執行，直到到達構造器鏈的最頂部； +- 當到達了構造器鏈最頂部，且已確保所有實例包含的存儲型屬性都已經賦值，這個實例的內存被認為已經完全初始化。此時階段1完成。 + +#### 階段 2 + +- 從頂部構造器鏈一直往下，每個構造器鏈中類的指定構造器都有機會進一步定制實例。構造器此時可以訪問`self`、修改它的屬性並調用實例方法等等。 +- 最終，任意構造器鏈中的便利構造器可以有機會定制實例和使用`self`。 + +下圖展示了在假定的子類和父類之間構造的階段1： +· +![構造過程階段1](https://developer.apple.com/library/prerelease/ios/documentation/swift/conceptual/swift_programming_language/Art/twoPhaseInitialization01_2x.png) + +在這個例子中，構造過程從對子類中一個便利構造器的調用開始。這個便利構造器此時沒法修改任何屬性，它把構造任務代理給同一類中的指定構造器。 + +如安全檢查1所示，指定構造器將確保所有子類的屬性都有值。然後它將調用父類的指定構造器，並沿著造器鏈一直往上完成父類的構建過程。 + +父類中的指定構造器確保所有父類的屬性都有值。由於沒有更多的父類需要構建，也就無需繼續向上做構建代理。 + +一旦父類中所有屬性都有了初始值，實例的內存被認為是完全初始化，而階段1也已完成。 + +以下展示了相同構造過程的階段2： + +![構建過程階段2](https://developer.apple.com/library/prerelease/ios/documentation/swift/conceptual/swift_programming_language/Art/twoPhaseInitialization02_2x.png) + +父類中的指定構造器現在有機會進一步來定制實例（儘管它沒有這種必要）。 + +一旦父類中的指定構造器完成調用，子類的構指定構造器可以執行更多的定制操作（同樣，它也沒有這種必要）。 + +最終，一旦子類的指定構造器完成調用，最開始被調用的便利構造器可以執行更多的定制操作。 + +### 構造器的繼承和重載 + +跟 Objective-C 中的子類不同，Swift 中的子類不會默認繼承父類的構造器。Swift 的這種機制可以防止一個父類的簡單構造器被一個更專業的子類繼承，並被錯誤的用來創建子類的實例。 + +假如你希望自定義的子類中能實現一個或多個跟父類相同的構造器--也許是為了完成一些定制的構造過程--你可以在你定制的子類中提供和重載與父類相同的構造器。 + +如果你重載的構造器是一個指定構造器，你可以在子類裡重載它的實現，並在自定義版本的構造器中調用父類版本的構造器。 + +如果你重載的構造器是一個便利構造器，你的重載過程必須通過調用同一類中提供的其它指定構造器來實現。這一規則的詳細內容請參考[構造器鏈](#initialization_chain)。 + +>注意： +與方法、屬性和下標不同，在重載構造器時你沒有必要使用關鍵字`override`。 + + +### 自動構造器的繼承 + +如上所述，子類不會默認繼承父類的構造器。但是如果特定條件可以滿足，父類構造器是可以被自動繼承的。在實踐中，這意味著對於許多常見場景你不必重載父類的構造器，並且在盡可能安全的情況下以最小的代價來繼承父類的構造器。 + +假設要為子類中引入的任意新屬性提供默認值，請遵守以下2個規則： + +#### 規則 1 + +如果子類沒有定義任何指定構造器，它將自動繼承所有父類的指定構造器。 + +#### 規則 2 + +如果子類提供了所有父類指定構造器的實現--不管是通過規則1繼承過來的，還是通過自定義實現的--它將自動繼承所有父類的便利構造器。 + +即使你在子類中添加了更多的便利構造器，這兩條規則仍然適用。 + +>注意： +子類可以通過部分滿足規則2的方式，使用子類便利構造器來實現父類的指定構造器。 + +### 指定構造器和便利構造器的語法 + +類的指定構造器的寫法跟值類型簡單構造器一樣： + +```swift +init(parameters) { + statements +} +``` + +便利構造器也採用相同樣式的寫法，但需要在`init`關鍵字之前放置`convenience`關鍵字，並使用空格將它們倆分開： + +```swift +convenience init(parameters) { + statements +} +``` + +### 指定構造器和便利構造器實戰 + +接下來的例子將在實戰中展示指定構造器、便利構造器和自動構造器的繼承。它定義了包含三個類`Food`、`RecipeIngredient`以及`ShoppingListItem`的類層次結構，並將演示它們的構造器是如何相互作用的。 + +類層次中的基類是`Food`，它是一個簡單的用來封裝食物名字的類。`Food`類引入了一個叫做`name`的`String`類型屬性，並且提供了兩個構造器來創建`Food`實例： + +```swift +class Food { + var name: String + init(name: String) { + self.name = name + } + convenience init() { + self.init(name: "[Unnamed]") + } +} +``` + +下圖中展示了`Food`的構造器鏈： + +![Food構造器鏈](https://developer.apple.com/library/prerelease/ios/documentation/swift/conceptual/swift_programming_language/Art/initializersExample01_2x.png) + +類沒有提供一個默認的逐一成員構造器，所以`Food`類提供了一個接受單一參數`name`的指定構造器。這個構造器可以使用一個特定的名字來創建新的`Food`實例： + +```swift +let namedMeat = Food(name: "Bacon") +// namedMeat 的名字是 "Bacon」 +``` + +`Food`類中的構造器`init(name: String)`被定義為一個指定構造器，因為它能確保所有新`Food`實例的中存儲型屬性都被初始化。`Food`類沒有父類，所以`init(name: String)`構造器不需要調用`super.init()`來完成構造。 + +`Food`類同樣提供了一個沒有參數的便利構造器 `init()`。這個`init()`構造器為新食物提供了一個默認的佔位名字，通過代理調用同一類中定義的指定構造器`init(name: String)`並給參數`name`傳值`[Unnamed]`來實現： + +```swift +let mysteryMeat = Food() +// mysteryMeat 的名字是 [Unnamed] +``` + +類層級中的第二個類是`Food`的子類`RecipeIngredient`。`RecipeIngredient`類構建了食譜中的一味調味劑。它引入了`Int`類型的數量屬性`quantity`（以及從`Food`繼承過來的`name`屬性），並且定義了兩個構造器來創建`RecipeIngredient`實例： + +```swift +class RecipeIngredient: Food { + var quantity: Int + init(name: String, quantity: Int) { + self.quantity = quantity + super.init(name: name) + } + convenience init(name: String) { + self.init(name: name, quantity: 1) + } +} +``` + +下圖中展示了`RecipeIngredient`類的構造器鏈： + +![RecipeIngredient構造器](https://developer.apple.com/library/prerelease/ios/documentation/swift/conceptual/swift_programming_language/Art/initializersExample02_2x.png) + +`RecipeIngredient`類擁有一個指定構造器`init(name: String, quantity: Int)`，它可以用來產生新`RecipeIngredient`實例的所有屬性值。這個構造器一開始先將傳入的`quantity`參數賦值給`quantity`屬性，這個屬性也是唯一在`RecipeIngredient`中新引入的屬性。隨後，構造器將任務向上代理給父類`Food`的`init(name: String)`。這個過程滿足[兩段式構造過程](#two_phase_initialization)中的安全檢查1。 + +`RecipeIngredient`也定義了一個便利構造器`init(name: String)`，它只通過`name`來創建`RecipeIngredient`的實例。這個便利構造器假設任意`RecipeIngredient`實例的`quantity`為1，所以不需要顯示指明數量即可創建出實例。這個便利構造器的定義可以讓創建實例更加方便和快捷，並且避免了使用重複的代碼來創建多個`quantity`為 1 的`RecipeIngredient`實例。這個便利構造器只是簡單的將任務代理給了同一類裡提供的指定構造器。 + +注意，`RecipeIngredient`的便利構造器`init(name: String)`使用了跟`Food`中指定構造器`init(name: String)`相同的參數。儘管`RecipeIngredient`這個構造器是便利構造器，`RecipeIngredient`依然提供了對所有父類指定構造器的實現。因此，`RecipeIngredient`也能自動繼承了所有父類的便利構造器。 + +在這個例子中，`RecipeIngredient`的父類是`Food`，它有一個便利構造器`init()`。這個構造器因此也被`RecipeIngredient`繼承。這個繼承的`init()`函數版本跟`Food`提供的版本是一樣的，除了它是將任務代理給`RecipeIngredient`版本的`init(name: String)`而不是`Food`提供的版本。 + +所有的這三種構造器都可以用來創建新的`RecipeIngredient`實例： + +```swift +let oneMysteryItem = RecipeIngredient() +let oneBacon = RecipeIngredient(name: "Bacon") +let sixEggs = RecipeIngredient(name: "Eggs", quantity: 6) +``` + +類層級中第三個也是最後一個類是`RecipeIngredient`的子類，叫做`ShoppingListItem`。這個類構建了購物單中出現的某一種調味料。 + +購物單中的每一項總是從`unpurchased`未購買狀態開始的。為了展現這一事實，`ShoppingListItem`引入了一個布爾類型的屬性`purchased`，它的默認值是`false`。`ShoppingListItem`還添加了一個計算型屬性`description`，它提供了關於`ShoppingListItem`實例的一些文字描述： + +```swift +class ShoppingListItem: RecipeIngredient { + var purchased = false + var description: String { + var output = "\(quantity) x \(name.lowercaseString)" + output += purchased ? " □" : " □" + return output + } +} +``` + +> 注意： +`ShoppingListItem`沒有定義構造器來為`purchased`提供初始化值，這是因為任何添加到購物單的項的初始狀態總是未購買。 + +由於它為自己引入的所有屬性都提供了默認值，並且自己沒有定義任何構造器，`ShoppingListItem`將自動繼承所有父類中的指定構造器和便利構造器。 + +下圖種展示了所有三個類的構造器鏈： + +![三類構造器圖](https://developer.apple.com/library/prerelease/ios/documentation/swift/conceptual/swift_programming_language/Art/initializersExample03_2x.png) + +你可以使用全部三個繼承來的構造器來創建`ShoppingListItem`的新實例： + +```swift +var breakfastList = [ + ShoppingListItem(), + ShoppingListItem(name: "Bacon"), + ShoppingListItem(name: "Eggs", quantity: 6), +] +breakfastList[0].name = "Orange juice" +breakfastList[0].purchased = true +for item in breakfastList { + println(item.description) +} +// 1 x orange juice □ +// 1 x bacon □ +// 6 x eggs □ +``` + +如上所述，例子中通過字面量方式創建了一個新數組`breakfastList`，它包含了三個新的`ShoppingListItem`實例，因此數組的類型也能自動推導為`ShoppingListItem[]`。在數組創建完之後，數組中第一個`ShoppingListItem`實例的名字從`[Unnamed]`修改為`Orange juice`，並標記為已購買。接下來通過遍歷數組每個元素並打印它們的描述值，展示了所有項當前的默認狀態都已按照預期完成了賦值。 + + +## 通過閉包和函數來設置屬性的默認值 + +如果某個存儲型屬性的默認值需要特別的定制或準備，你就可以使用閉包或全局函數來為其屬性提供定制的默認值。每當某個屬性所屬的新類型實例創建時，對應的閉包或函數會被調用，而它們的返回值會當做默認值賦值給這個屬性。 + +這種類型的閉包或函數一般會創建一個跟屬性類型相同的臨時變量，然後修改它的值以滿足預期的初始狀態，最後將這個臨時變量的值作為屬性的默認值進行返回。 + +下面列舉了閉包如何提供默認值的代碼概要： + +```swift +class SomeClass { + let someProperty: SomeType = { + // 在這個閉包中給 someProperty 創建一個默認值 + // someValue 必須和 SomeType 類型相同 + return someValue + }() +} +``` + +注意閉包結尾的大括號後面接了一對空的小括號。這是用來告訴 Swift 需要立刻執行此閉包。如果你忽略了這對括號，相當於是將閉包本身作為值賦值給了屬性，而不是將閉包的返回值賦值給屬性。 + +>注意： +如果你使用閉包來初始化屬性的值，請記住在閉包執行時，實例的其它部分都還沒有初始化。這意味著你不能夠在閉包裡訪問其它的屬性，就算這個屬性有默認值也不允許。同樣，你也不能使用隱式的`self`屬性，或者調用其它的實例方法。 + +下面例子中定義了一個結構體`Checkerboard`，它構建了西洋跳棋遊戲的棋盤： + +![西洋跳棋棋盤](https://developer.apple.com/library/prerelease/ios/documentation/swift/conceptual/swift_programming_language/Art/checkersBoard_2x.png) + +西洋跳棋遊戲在一副黑白格交替的 10x10 的棋盤中進行。為了呈現這副遊戲棋盤，`Checkerboard`結構體定義了一個屬性`boardColors`，它是一個包含 100 個布爾值的數組。數組中的某元素布爾值為`true`表示對應的是一個黑格，布爾值為`false`表示對應的是一個白格。數組中第一個元素代表棋盤上左上角的格子，最後一個元素代表棋盤上右下角的格子。 + +`boardColor`數組是通過一個閉包來初始化和組裝顏色值的： + +```swift +struct Checkerboard { + let boardColors: Bool[] = { + var temporaryBoard = Bool[]() + var isBlack = false + for i in 1...10 { + for j in 1...10 { + temporaryBoard.append(isBlack) + isBlack = !isBlack + } + isBlack = !isBlack + } + return temporaryBoard + }() + func squareIsBlackAtRow(row: Int, column: Int) -> Bool { + return boardColors[(row * 10) + column] + } +} +``` + +每當一個新的`Checkerboard`實例創建時，對應的賦值閉包會執行，一系列顏色值會被計算出來作為默認值賦值給`boardColors`。上面例子中描述的閉包將計算出棋盤中每個格子合適的顏色，將這些顏色值保存到一個臨時數組`temporaryBoard`中，並在構建完成時將此數組作為閉包返回值返回。這個返回的值將保存到`boardColors`中，並可以通`squareIsBlackAtRow`這個工具函數來查詢。 + +```swift +let board = Checkerboard() +println(board.squareIsBlackAtRow(0, column: 1)) +// 輸出 "true" +println(board.squareIsBlackAtRow(9, column: 9)) +// 輸出 "false" +``` diff --git a/source-tw/chapter2/15_Deinitialization.md b/source-tw/chapter2/15_Deinitialization.md new file mode 100644 index 00000000..bc2e0d3b --- /dev/null +++ b/source-tw/chapter2/15_Deinitialization.md @@ -0,0 +1,108 @@ +> 翻譯：[bruce0505](https://github.com/bruce0505) +> 校對：[fd5788](https://github.com/fd5788) + +# 析構過程（Deinitialization） +--------------------------- + +本頁包含內容： + +- [析構過程原理](#how_deinitialization_works) +- [析構函數操作](#deinitializers_in_action) + +在一個類的實例被釋放之前，析構函數被立即調用。用關鍵字`deinit`來標示析構函數，類似於初始化函數用`init`來標示。析構函數只適用於類類型。 + + +##析構過程原理 + +Swift 會自動釋放不再需要的實例以釋放資源。如[自動引用計數](16_Automatic_Reference_Counting.html)那一章描述，Swift 通過_自動引用計數_（ARC）處理實例的內存管理。通常當你的實例被釋放時不需要手動地去清理。但是，當使用自己的資源時，你可能需要進行一些額外的清理。例如，如果創建了一個自定義的類來打開一個文件，並寫入一些數據，你可能需要在類實例被釋放之前關閉該文件。 + +在類的定義中，每個類最多只能有一個析構函數。析構函數不帶任何參數，在寫法上不帶括號： + +```swift +deinit { + // 執行析構過程 +} +``` + +析構函數是在實例釋放發生前一步被自動調用。不允許主動調用自己的析構函數。子類繼承了父類的析構函數，並且在子類析構函數實現的最後，父類的析構函數被自動調用。即使子類沒有提供自己的析構函數，父類的析構函數也總是被調用。 + +因為直到實例的析構函數被調用時，實例才會被釋放，所以析構函數可以訪問所有請求實例的屬性，並且根據那些屬性可以修改它的行為（比如查找一個需要被關閉的文件的名稱）。 + + +##析構函數操作 + +這裡是一個析構函數操作的例子。這個例子是一個簡單的遊戲，定義了兩種新類型，`Bank`和`Player`。`Bank`結構體管理一個虛擬貨幣的流通，在這個流通中`Bank`永遠不可能擁有超過 10,000 的硬幣。在這個遊戲中有且只能有一個`Bank`存在，因此`Bank`由帶有靜態屬性和靜態方法的結構體實現，從而存儲和管理其當前的狀態。 + +```swift +struct Bank { + static var coinsInBank = 10_000 + static func vendCoins(var numberOfCoinsToVend: Int) -> Int { + numberOfCoinsToVend = min(numberOfCoinsToVend, coinsInBank) + coinsInBank -= numberOfCoinsToVend + return numberOfCoinsToVend + } + static func receiveCoins(coins: Int) { + coinsInBank += coins + } +} +``` + +`Bank`根據它的`coinsInBank`屬性來跟蹤當前它擁有的硬幣數量。銀行還提供兩個方法——`vendCoins`和`receiveCoins`——用來處理硬幣的分發和收集。 + +`vendCoins`方法在 bank 分發硬幣之前檢查是否有足夠的硬幣。如果沒有足夠多的硬幣，`Bank`返回一個比請求時小的數字(如果沒有硬幣留在 bank 中就返回 0)。`vendCoins`方法聲明`numberOfCoinsToVend`為一個變量參數，這樣就可以在方法體的內部修改數字，而不需要定義一個新的變量。`vendCoins`方法返回一個整型值，表明了提供的硬幣的實際數目。 + +`receiveCoins`方法只是將 bank 的硬幣存儲和接收到的硬幣數目相加，再保存回 bank。 + +`Player`類描述了遊戲中的一個玩家。每一個 player 在任何時刻都有一定數量的硬幣存儲在他們的錢包中。這通過 player 的`coinsInPurse`屬性來體現： + +```swift +class Player { + var coinsInPurse: Int + init(coins: Int) { + coinsInPurse = Bank.vendCoins(coins) + } + func winCoins(coins: Int) { + coinsInPurse += Bank.vendCoins(coins) + } + deinit { + Bank.receiveCoins(coinsInPurse) + } +} +``` + + +每個`Player`實例都由一個指定數目硬幣組成的啟動額度初始化，這些硬幣在 bank 初始化的過程中得到。如果沒有足夠的硬幣可用，`Player`實例可能收到比指定數目少的硬幣。 + +`Player`類定義了一個`winCoins`方法，該方法從銀行獲取一定數量的硬幣，並把它們添加到玩家的錢包。`Player`類還實現了一個析構函數，這個析構函數在`Player`實例釋放前一步被調用。這裡析構函數只是將玩家的所有硬幣都返回給銀行： + +```swift +var playerOne: Player? = Player(coins: 100) +println("A new player has joined the game with \(playerOne!.coinsInPurse) coins") +// 輸出 "A new player has joined the game with 100 coins" +println("There are now \(Bank.coinsInBank) coins left in the bank") +// 輸出 "There are now 9900 coins left in the bank" +``` + +一個新的`Player`實例隨著一個 100 個硬幣（如果有）的請求而被創建。這`個Player`實例存儲在一個名為`playerOne`的可選`Player`變量中。這裡使用一個可選變量，是因為玩家可以隨時離開遊戲。設置為可選使得你可以跟蹤當前是否有玩家在遊戲中。 + +因為`playerOne`是可選的，所以由一個感歎號（`!`）來修飾，每當其`winCoins`方法被調用時，`coinsInPurse`屬性被訪問並打印出它的默認硬幣數目。 + +```swift +playerOne!.winCoins(2_000) +println("PlayerOne won 2000 coins & now has \ (playerOne!.coinsInPurse) coins") +// 輸出 "PlayerOne won 2000 coins & now has 2100 coins" +println("The bank now only has \(Bank.coinsInBank) coins left") +// 輸出 "The bank now only has 7900 coins left" +``` + +這裡，player 已經贏得了 2,000 硬幣。player 的錢包現在有 2,100 硬幣，bank 只剩餘 7,900 硬幣。 + +```swift +playerOne = nil +println("PlayerOne has left the game") +// 輸出 "PlayerOne has left the game" +println("The bank now has \(Bank.coinsInBank) coins") +// 輸出 "The bank now has 10000 coins" +``` + +玩家現在已經離開了遊戲。這表明是要將可選的`playerOne`變量設置為`nil`，意思是「沒有`Player`實例」。當這種情況發生的時候，`playerOne`變量對`Player`實例的引用被破壞了。沒有其它屬性或者變量引用`Player`實例，因此為了清空它佔用的內存從而釋放它。在這發生前一步，其析構函數被自動調用，其硬幣被返回到銀行。 diff --git a/source-tw/chapter2/16_Automatic_Reference_Counting.md b/source-tw/chapter2/16_Automatic_Reference_Counting.md new file mode 100644 index 00000000..15fab276 --- /dev/null +++ b/source-tw/chapter2/16_Automatic_Reference_Counting.md @@ -0,0 +1,555 @@ +> 翻譯：[TimothyYe](https://github.com/TimothyYe) +> 校對：[Hawstein](https://github.com/Hawstein) + +# 自動引用計數 +----------------- + +本頁包含內容： + +- [自動引用計數的工作機制](#how_arc_works) +- [自動引用計數實踐](#arc_in_action) +- [類實例之間的循環強引用](#strong_reference_cycles_between_class_instances) +- [解決實例之間的循環強引用](#resolving_strong_reference_cycles_between_class_instances) +- [閉包引起的循環強引用](#strong_reference_cycles_for_closures) +- [解決閉包引起的循環強引用](#resolving_strong_reference_cycles_for_closures) + +Swift 使用自動引用計數（ARC）這一機制來跟蹤和管理你的應用程序的內存。通常情況下，Swift 的內存管理機制會一直起著作用，你無須自己來考慮內存的管理。ARC 會在類的實例不再被使用時，自動釋放其佔用的內存。 + +然而，在少數情況下，ARC 為了能幫助你管理內存，需要更多的關於你的代碼之間關係的信息。本章描述了這些情況，並且為你示範怎樣啟用 ARC 來管理你的應用程序的內存。 + +> 注意: +引用計數僅僅應用於類的實例。結構體和枚舉類型是值類型，不是引用類型，也不是通過引用的方式存儲和傳遞。 + + +## 自動引用計數的工作機制 + +當你每次創建一個類的新的實例的時候，ARC 會分配一大塊內存用來儲存實例的信息。內存中會包含實例的類型信息，以及這個實例所有相關屬性的值。此外，當實例不再被使用時，ARC 釋放實例所佔用的內存，並讓釋放的內存能挪作他用。這確保了不再被使用的實例，不會一直佔用內存空間。 + +然而，當 ARC 收回和釋放了正在被使用中的實例，該實例的屬性和方法將不能再被訪問和調用。實際上，如果你試圖訪問這個實例，你的應用程序很可能會崩潰。 + +為了確保使用中的實例不會被銷毀，ARC 會跟蹤和計算每一個實例正在被多少屬性，常量和變量所引用。哪怕實例的引用數為一，ARC都不會銷毀這個實例。 + +為了使之成為可能，無論你將實例賦值給屬性，常量或者是變量，屬性，常量或者變量，都會對此實例創建強引用。之所以稱之為強引用，是因為它會將實例牢牢的保持住，只要強引用還在，實例是不允許被銷毀的。 + + +## 自動引用計數實踐 + +下面的例子展示了自動引用計數的工作機制。例子以一個簡單的`Person`類開始，並定義了一個叫`name`的常量屬性： + +```swift +class Person { + let name: String + init(name: String) { + self.name = name + println("\(name) is being initialized") + } + deinit { + println("\(name) is being deinitialized") + } +} +``` + +`Person`類有一個構造函數，此構造函數為實例的`name`屬性賦值並打印出信息，以表明初始化過程生效。`Person`類同時也擁有析構函數，同樣會在實例被銷毀的時候打印出信息。 + +接下來的代碼片段定義了三個類型為`Person?`的變量，用來按照代碼片段中的順序，為新的`Person`實例建立多個引用。由於這些變量是被定義為可選類型（Person?，而不是Person），它們的值會被自動初始化為`nil`，目前還不會引用到`Person`類的實例。 + +```swift +var reference1: Person? +var reference2: Person? +var reference3: Person? +``` + +現在你可以創建`Person`類的新實例，並且將它賦值給三個變量其中的一個： + +```swift +reference1 = Person(name: "John Appleseed") +// prints "John Appleseed is being initialized」 +``` + +應當注意到當你調用`Person`類的構造函數的時候，"John Appleseed is being initialized」會被打印出來。由此可以確定構造函數被執行。 + +由於`Person`類的新實例被賦值給了`reference1`變量，所以`reference1`到`Person`類的新實例之間建立了一個強引用。正是因為這個強引用，ARC 會保證`Person`實例被保持在內存中不被銷毀。 + +如果你將同樣的`Person`實例也賦值給其他兩個變量，該實例又會多出兩個強引用： + +```swift +reference2 = reference1 +reference3 = reference1 +``` + +現在這個`Person`實例已經有三個強引用了。 + +如果你通過給兩個變量賦值`nil`的方式斷開兩個強引用（）包括最先的那個強引用），只留下一個強引用，`Person`實例不會被銷毀： + +```swift +reference1 = nil +reference2 = nil +``` + +ARC 會在第三個，也即最後一個強引用被斷開的時候，銷毀`Person`實例，這也意味著你不再使用這個`Person`實例： + +```swift +reference3 = nil +// prints "John Appleseed is being deinitialized" +``` + + +## 類實例之間的循環強引用 + +在上面的例子中，ARC 會跟蹤你所新創建的`Person`實例的引用數量，並且會在`Person`實例不再被需要時銷毀它。 + +然而，我們可能會寫出這樣的代碼，一個類永遠不會有0個強引用。這種情況發生在兩個類實例互相保持對方的強引用，並讓對方不被銷毀。這就是所謂的循環強引用。 + +你可以通過定義類之間的關係為弱引用或者無主引用，以此替代強引用，從而解決循環強引用的問題。具體的過程在[解決類實例之間的循環強引用](#resolving_strong_reference_cycles_between_class_instances)中有描述。不管怎樣，在你學習怎樣解決循環強引用之前，很有必要瞭解一下它是怎樣產生的。 + +下面展示了一個不經意產生循環強引用的例子。例子定義了兩個類：`Person`和`Apartment`，用來建模公寓和它其中的居民: + +```swift +class Person { + let name: String + init(name: String) { self.name = name } + var apartment: Apartment? + deinit { println("\(name) is being deinitialized") } +} +``` + +```swift +class Apartment { + let number: Int + init(number: Int) { self.number = number } + var tenant: Person? + deinit { println("Apartment #\(number) is being deinitialized") } +} +``` + +每一個`Person`實例有一個類型為`String`，名字為`name`的屬性，並有一個可選的初始化為`nil`的`apartment`屬性。`apartment`屬性是可選的，因為一個人並不總是擁有公寓。 + +類似的，每個`Apartment`實例有一個叫`number`，類型為`Int`的屬性，並有一個可選的初始化為`nil`的`tenant`屬性。`tenant`屬性是可選的，因為一棟公寓並不總是有居民。 + +這兩個類都定義了析構函數，用以在類實例被析構的時候輸出信息。這讓你能夠知曉`Person`和`Apartment`的實例是否像預期的那樣被銷毀。 + +接下來的代碼片段定義了兩個可選類型的變量`john`和`number73`,並分別被設定為下面的`Apartment`和`Person`的實例。這兩個變量都被初始化為`nil`，並為可選的： + +```swift +var john: Person? +var number73: Apartment? +``` + +現在你可以創建特定的`Person`和`Apartment`實例並將類實例賦值給`john`和`number73`變量： + +```swift +john = Person(name: "John Appleseed") +number73 = Apartment(number: 73) +``` + +在兩個實例被創建和賦值後，下圖表現了強引用的關係。變量`john`現在有一個指向`Person`實例的強引用，而變量`number73`有一個指向`Apartment`實例的強引用： + +![](https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/Art/referenceCycle01_2x.png) + +現在你能夠將這兩個實例關聯在一起，這樣人就能有公寓住了，而公寓也有了房客。注意感歎號是用來展開和訪問可選變量`john`和`number73`中的實例，這樣實例的屬性才能被賦值： + +```swift +john!.apartment = number73 +number73!.tenant = john +``` + +在將兩個實例聯繫在一起之後，強引用的關係如圖所示： + +![](https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/Art/referenceCycle02_2x.png) + +不幸的是，將這兩個實例關聯在一起之後，一個循環強引用被創建了。`Person`實例現在有了一個指向`Apartment`實例的強引用，而`Apartment`實例也有了一個指向`Person`實例的強引用。因此，當你斷開`john`和`number73`變量所持有的強引用時，引用計數並不會降為 0，實例也不會被 ARC 銷毀： + +```swift +john = nil +number73 = nil +``` + +注意，當你把這兩個變量設為`nil`時，沒有任何一個析構函數被調用。強引用循環阻止了`Person`和`Apartment`類實例的銷毀，並在你的應用程序中造成了內存洩漏。 + +在你將`john`和`number73`賦值為`nil`後，強引用關係如下圖： + +![](https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/Art/referenceCycle03_2x.png) + +`Person`和`Apartment`實例之間的強引用關係保留了下來並且不會被斷開。 + + +## 解決實例之間的循環強引用 + +Swift 提供了兩種辦法用來解決你在使用類的屬性時所遇到的循環強引用問題：弱引用（weak reference）和無主引用（unowned reference）。 + +弱引用和無主引用允許循環引用中的一個實例引用另外一個實例而不保持強引用。這樣實例能夠互相引用而不產生循環強引用。 + +對於生命週期中會變為`nil`的實例使用弱引用。相反的，對於初始化賦值後再也不會被賦值為`nil`的實例，使用無主引用。 + +### 弱引用 + +弱引用不會牢牢保持住引用的實例，並且不會阻止 ARC 銷毀被引用的實例。這種行為阻止了引用變為循環強引用。聲明屬性或者變量時，在前面加上`weak`關鍵字表明這是一個弱引用。 + +在實例的生命週期中，如果某些時候引用沒有值，那麼弱引用可以阻止循環強引用。如果引用總是有值，則可以使用無主引用，在[無主引用](#2)中有描述。在上面`Apartment`的例子中，一個公寓的生命週期中，有時是沒有「居民」的，因此適合使用弱引用來解決循環強引用。 + +> 注意: +> 弱引用必須被聲明為變量，表明其值能在運行時被修改。弱引用不能被聲明為常量。 + +因為弱引用可以沒有值，你必須將每一個弱引用聲明為可選類型。可選類型是在 Swift 語言中推薦的用來表示可能沒有值的類型。 + +因為弱引用不會保持所引用的實例，即使引用存在，實例也有可能被銷毀。因此，ARC 會在引用的實例被銷毀後自動將其賦值為`nil`。你可以像其他可選值一樣，檢查弱引用的值是否存在，你永遠也不會遇到被銷毀了而不存在的實例。 + +下面的例子跟上面`Person`和`Apartment`的例子一致，但是有一個重要的區別。這一次，`Apartment`的`tenant`屬性被聲明為弱引用： + +```swift +class Person { + let name: String + init(name: String) { self.name = name } + var apartment: Apartment? + deinit { println("\(name) is being deinitialized") } +} +``` + +```swift +class Apartment { + let number: Int + init(number: Int) { self.number = number } + weak var tenant: Person? + deinit { println("Apartment #\(number) is being deinitialized") } +} +``` + +然後跟之前一樣，建立兩個變量（john和number73）之間的強引用，並關聯兩個實例： + +```swift +var john: Person? +var number73: Apartment? + +john = Person(name: "John Appleseed") +number73 = Apartment(number: 73) + +john!.apartment = number73 +number73!.tenant = john +``` + +現在，兩個關聯在一起的實例的引用關係如下圖所示： + +![](https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/Art/weakReference01_2x.png) + +`Person`實例依然保持對`Apartment`實例的強引用，但是`Apartment`實例只是對`Person`實例的弱引用。這意味著當你斷開`john`變量所保持的強引用時，再也沒有指向`Person`實例的強引用了： + +![](https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/Art/weakReference02_2x.png) + +由於再也沒有指向`Person`實例的強引用，該實例會被銷毀： + +```swift +john = nil +// prints "John Appleseed is being deinitialized" +``` + +唯一剩下的指向`Apartment`實例的強引用來自於變量`number73`。如果你斷開這個強引用，再也沒有指向`Apartment`實例的強引用了： + +![](https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/Art/weakReference03_2x.png) + +由於再也沒有指向`Apartment`實例的強引用，該實例也會被銷毀： + +```swift +number73 = nil +// prints "Apartment #73 is being deinitialized" +``` + +上面的兩段代碼展示了變量`john`和`number73`在被賦值為`nil`後，`Person`實例和`Apartment`實例的析構函數都打印出「銷毀」的信息。這證明了引用循環被打破了。 + + +### 無主引用 + +和弱引用類似，無主引用不會牢牢保持住引用的實例。和弱引用不同的是，無主引用是永遠有值的。因此，無主引用總是被定義為非可選類型（non-optional type）。你可以在聲明屬性或者變量時，在前面加上關鍵字`unowned`表示這是一個無主引用。 + +由於無主引用是非可選類型，你不需要在使用它的時候將它展開。無主引用總是可以被直接訪問。不過 ARC 無法在實例被銷毀後將無主引用設為`nil`，因為非可選類型的變量不允許被賦值為`nil`。 + +> 注意: +>如果你試圖在實例被銷毀後，訪問該實例的無主引用，會觸發運行時錯誤。使用無主引用，你必須確保引用始終指向一個未銷毀的實例。 +> 還需要注意的是如果你試圖訪問實例已經被銷毀的無主引用，程序會直接崩潰，而不會發生無法預期的行為。所以你應當避免這樣的事情發生。 + +下面的例子定義了兩個類，`Customer`和`CreditCard`，模擬了銀行客戶和客戶的信用卡。這兩個類中，每一個都將另外一個類的實例作為自身的屬性。這種關係會潛在的創造循環強引用。 + +`Customer`和`CreditCard`之間的關係與前面弱引用例子中`Apartment`和`Person`的關係截然不同。在這個數據模型中，一個客戶可能有或者沒有信用卡，但是一張信用卡總是關聯著一個客戶。為了表示這種關係，`Customer`類有一個可選類型的`card`屬性，但是`CreditCard`類有一個非可選類型的`customer`屬性。 + +此外，只能通過將一個`number`值和`customer`實例傳遞給`CreditCard`構造函數的方式來創建`CreditCard`實例。這樣可以確保當創建`CreditCard`實例時總是有一個`customer`實例與之關聯。 + +由於信用卡總是關聯著一個客戶，因此將`customer`屬性定義為無主引用，用以避免循環強引用： + +```swift +class Customer { + let name: String + var card: CreditCard? + init(name: String) { + self.name = name + } + deinit { println("\(name) is being deinitialized") } +} +``` + +```swift +class CreditCard { + let number: Int + unowned let customer: Customer + init(number: Int, customer: Customer) { + self.number = number + self.customer = customer + } + deinit { println("Card #\(number) is being deinitialized") } +} +``` + +下面的代碼片段定義了一個叫`john`的可選類型`Customer`變量，用來保存某個特定客戶的引用。由於是可選類型，所以變量被初始化為`nil`。 + +```swift +var john: Customer? +``` + +現在你可以創建`Customer`類的實例，用它初始化`CreditCard`實例，並將新創建的`CreditCard`實例賦值為客戶的`card`屬性。 + +```swift +john = Customer(name: "John Appleseed") +john!.card = CreditCard(number: 1234_5678_9012_3456, customer: john!) +``` + +在你關聯兩個實例後，它們的引用關係如下圖所示： + +![](https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/Art/unownedReference01_2x.png) + +`Customer`實例持有對`CreditCard`實例的強引用，而`CreditCard`實例持有對`Customer`實例的無主引用。 + +由於`customer`的無主引用，當你斷開`john`變量持有的強引用時，再也沒有指向`Customer`實例的強引用了： + +![](https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/Art/unownedReference02_2x.png) + +由於再也沒有指向`Customer`實例的強引用，該實例被銷毀了。其後，再也沒有指向`CreditCard`實例的強引用，該實例也隨之被銷毀了： + +```swift +john = nil +// prints "John Appleseed is being deinitialized" +// prints "Card #1234567890123456 is being deinitialized" +``` + +最後的代碼展示了在`john`變量被設為`nil`後`Customer`實例和`CreditCard`實例的構造函數都打印出了「銷毀」的信息。 + +###無主引用以及隱式解析可選屬性 + +上面弱引用和無主引用的例子涵蓋了兩種常用的需要打破循環強引用的場景。 + +`Person`和`Apartment`的例子展示了兩個屬性的值都允許為`nil`，並會潛在的產生循環強引用。這種場景最適合用弱引用來解決。 + +`Customer`和`CreditCard`的例子展示了一個屬性的值允許為`nil`，而另一個屬性的值不允許為`nil`，並會潛在的產生循環強引用。這種場景最適合通過無主引用來解決。 + +然而，存在著第三種場景，在這種場景中，兩個屬性都必須有值，並且初始化完成後不能為`nil`。在這種場景中，需要一個類使用無主屬性，而另外一個類使用隱式解析可選屬性。 + +這使兩個屬性在初始化完成後能被直接訪問（不需要可選展開），同時避免了循環引用。這一節將為你展示如何建立這種關係。 + +下面的例子定義了兩個類，`Country`和`City`，每個類將另外一個類的實例保存為屬性。在這個模型中，每個國家必須有首都，而每一個城市必須屬於一個國家。為了實現這種關係，`Country`類擁有一個`capitalCity`屬性，而`City`類有一個`country`屬性： + +```swift +class Country { + let name: String + let capitalCity: City! + init(name: String, capitalName: String) { + self.name = name + self.capitalCity = City(name: capitalName, country: self) + } +} +``` + +```swift +class City { + let name: String + unowned let country: Country + init(name: String, country: Country) { + self.name = name + self.country = country + } +} +``` + +為了建立兩個類的依賴關係，`City`的構造函數有一個`Country`實例的參數，並且將實例保存為`country`屬性。 + +`Country`的構造函數調用了`City`的構造函數。然而，只有`Country`的實例完全初始化完後，`Country`的構造函數才能把`self`傳給`City`的構造函數。（[在兩段式構造過程中有具體描述](14_Initialization.html)） + +為了滿足這種需求，通過在類型結尾處加上感歎號（City!）的方式，將`Country`的`capitalCity`屬性聲明為隱式解析可選類型的屬性。這表示像其他可選類型一樣，`capitalCity`屬性的默認值為`nil`，但是不需要展開它的值就能訪問它。（[在隱式解析可選類型中有描述](01_The_Basics.html)） + +由於`capitalCity`默認值為`nil`，一旦`Country`的實例在構造函數中給`name`屬性賦值後，整個初始化過程就完成了。這代表一旦`name`屬性被賦值後，`Country`的構造函數就能引用並傳遞隱式的`self`。`Country`的構造函數在賦值`capitalCity`時，就能將`self`作為參數傳遞給`City`的構造函數。 + +以上的意義在於你可以通過一條語句同時創建`Country`和`City`的實例，而不產生循環強引用，並且`capitalCity`的屬性能被直接訪問，而不需要通過感歎號來展開它的可選值： + +```swift +var country = Country(name: "Canada", capitalName: "Ottawa") +println("\(country.name)'s capital city is called \(country.capitalCity.name)") +// prints "Canada's capital city is called Ottawa" +``` + +在上面的例子中，使用隱式解析可選值的意義在於滿足了兩個類構造函數的需求。`capitalCity`屬性在初始化完成後，能像非可選值一樣使用和存取同時還避免了循環強引用。 + + +##閉包引起的循環強引用 + +前面我們看到了循環強引用環是在兩個類實例屬性互相保持對方的強引用時產生的，還知道了如何用弱引用和無主引用來打破循環強引用。 + +循環強引用還會發生在當你將一個閉包賦值給類實例的某個屬性，並且這個閉包體中又使用了實例。這個閉包體中可能訪問了實例的某個屬性，例如`self.someProperty`，或者閉包中調用了實例的某個方法，例如`self.someMethod`。這兩種情況都導致了閉包 「捕獲" `self`，從而產生了循環強引用。 + +循環強引用的產生，是因為閉包和類相似，都是引用類型。當你把一個閉包賦值給某個屬性時，你也把一個引用賦值給了這個閉包。實質上，這跟之前的問題是一樣的－兩個強引用讓彼此一直有效。但是，和兩個類實例不同，這次一個是類實例，另一個是閉包。 + +Swift 提供了一種優雅的方法來解決這個問題，稱之為閉包佔用列表（closuer capture list）。同樣的，在學習如何用閉包佔用列表破壞循環強引用之前，先來瞭解一下循環強引用是如何產生的，這對我們是很有幫助的。 + +下面的例子為你展示了當一個閉包引用了`self`後是如何產生一個循環強引用的。例子中定義了一個叫`HTMLElement`的類，用一種簡單的模型表示 HTML 中的一個單獨的元素： + +```swift +class HTMLElement { + + let name: String + let text: String? + + @lazy var asHTML: () -> String = { + if let text = self.text { + return "<\(self.name)>\(text)" + } else { + return "<\(self.name) />" + } + } + + init(name: String, text: String? = nil) { + self.name = name + self.text = text + } + + deinit { + println("\(name) is being deinitialized") + } + +} +``` + +`HTMLElement`類定義了一個`name`屬性來表示這個元素的名稱，例如代表段落的"p"，或者代表換行的"br"。`HTMLElement`還定義了一個可選屬性`text`，用來設置和展現 HTML 元素的文本。 + +除了上面的兩個屬性，`HTMLElement`還定義了一個`lazy`屬性`asHTML`。這個屬性引用了一個閉包，將`name`和`text`組合成 HTML 字符串片段。該屬性是`() -> String`類型，或者可以理解為「一個沒有參數，返回`String`的函數」。 + +默認情況下，閉包賦值給了`asHTML`屬性，這個閉包返回一個代表 HTML 標籤的字符串。如果`text`值存在，該標籤就包含可選值`text`；如果`text`不存在，該標籤就不包含文本。對於段落元素，根據`text`是"some text"還是`nil`，閉包會返回"`

some text

`"或者"`

`"。 + +可以像實例方法那樣去命名、使用`asHTML`屬性。然而，由於`asHTML`是閉包而不是實例方法，如果你想改變特定元素的 HTML 處理的話，可以用自定義的閉包來取代默認值。 + +> 注意: +`asHTML`聲明為`lazy`屬性，因為只有當元素確實需要處理為HTML輸出的字符串時，才需要使用`asHTML`。也就是說，在默認的閉包中可以使用`self`，因為只有當初始化完成以及`self`確實存在後，才能訪問`lazy`屬性。 + +`HTMLElement`類只提供一個構造函數，通過`name`和`text`（如果有的話）參數來初始化一個元素。該類也定義了一個析構函數，當`HTMLElement`實例被銷毀時，打印一條消息。 + +下面的代碼展示了如何用`HTMLElement`類創建實例並打印消息。 + +```swift +var paragraph: HTMLElement? = HTMLElement(name: "p", text: "hello, world") +println(paragraph!.asHTML()) +// prints"hello, world" +``` + +>注意: +上面的`paragraph`變量定義為`可選HTMLElement`，因此我們可以賦值`nil`給它來演示循環強引用。 + +不幸的是，上面寫的`HTMLElement`類產生了類實例和`asHTML`默認值的閉包之間的循環強引用。循環強引用如下圖所示： + +![](https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/Art/closureReferenceCycle01_2x.png) + +實例的`asHTML`屬性持有閉包的強引用。但是，閉包在其閉包體內使用了`self`（引用了`self.name`和`self.text`），因此閉包捕獲了`self`，這意味著閉包又反過來持有了`HTMLElement`實例的強引用。這樣兩個對象就產生了循環強引用。（更多關於閉包捕獲值的信息，請參考[值捕獲](07_Closures.html)）。 + +>注意: +雖然閉包多次使用了`self`，它只捕獲`HTMLElement`實例的一個強引用。 + +如果設置`paragraph`變量為`nil`，打破它持有的`HTMLElement`實例的強引用，`HTMLElement`實例和它的閉包都不會被銷毀，也是因為循環強引用： + +```swift +paragraph = nil +``` + +注意`HTMLElementdeinitializer`中的消息並沒有別打印，證明了`HTMLElement`實例並沒有被銷毀。 + + +##解決閉包引起的循環強引用 + +在定義閉包時同時定義捕獲列表作為閉包的一部分，通過這種方式可以解決閉包和類實例之間的循環強引用。捕獲列表定義了閉包體內捕獲一個或者多個引用類型的規則。跟解決兩個類實例間的循環強引用一樣，聲明每個捕獲的引用為弱引用或無主引用，而不是強引用。應當根據代碼關係來決定使用弱引用還是無主引用。 + +>注意: +Swift 有如下要求：只要在閉包內使用`self`的成員，就要用`self.someProperty`或者`self.someMethod`（而不只是`someProperty`或`someMethod`）。這提醒你可能會不小心就捕獲了`self`。 + +###定義捕獲列表 + +捕獲列表中的每個元素都是由`weak`或者`unowned`關鍵字和實例的引用（如`self`或`someInstance`）成對組成。每一對都在方括號中，通過逗號分開。 + +捕獲列表放置在閉包參數列表和返回類型之前： + +```swift +@lazy var someClosure: (Int, String) -> String = { + [unowned self] (index: Int, stringToProcess: String) -> String in + // closure body goes here +} +``` + +如果閉包沒有指定參數列表或者返回類型，則可以通過上下文推斷，那麼可以捕獲列表放在閉包開始的地方，跟著是關鍵字`in`： + +```swift +@lazy var someClosure: () -> String = { + [unowned self] in + // closure body goes here +} +``` + +###弱引用和無主引用 + +當閉包和捕獲的實例總是互相引用時並且總是同時銷毀時，將閉包內的捕獲定義為無主引用。 + +相反的，當捕獲引用有時可能會是`nil`時，將閉包內的捕獲定義為弱引用。弱引用總是可選類型，並且當引用的實例被銷毀後，弱引用的值會自動置為`nil`。這使我們可以在閉包內檢查它們是否存在。 + +>注意: +如果捕獲的引用絕對不會置為`nil`，應該用無主引用，而不是弱引用。 + +前面的`HTMLElement`例子中，無主引用是正確的解決循環強引用的方法。這樣編寫`HTMLElement`類來避免循環強引用： + +```swift +class HTMLElement { + + let name: String + let text: String? + + @lazy var asHTML: () -> String = { + [unowned self] in + if let text = self.text { + return "<\(self.name)>\(text)" + } else { + return "<\(self.name) />" + } + } + + init(name: String, text: String? = nil) { + self.name = name + self.text = text + } + + deinit { + println("\(name) is being deinitialized") + } + +} +``` + +上面的`HTMLElement`實現和之前的實現一致，只是在`asHTML`閉包中多了一個捕獲列表。這裡，捕獲列表是`[unowned self]`，表示「用無主引用而不是強引用來捕獲`self`」。 + +和之前一樣，我們可以創建並打印`HTMLElement`實例： + +```swift +var paragraph: HTMLElement? = HTMLElement(name: "p", text: "hello, world") +println(paragraph!.asHTML()) +// prints "

hello, world

" +``` + +使用捕獲列表後引用關係如下圖所示： + +![](https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/Art/closureReferenceCycle02_2x.png) + +這一次，閉包以無主引用的形式捕獲`self`，並不會持有`HTMLElement`實例的強引用。如果將`paragraph`賦值為`nil`，`HTMLElement`實例將會被銷毀，並能看到它的析構函數打印出的消息。 + +```swift +paragraph = nil +// prints "p is being deinitialized" +``` + diff --git a/source-tw/chapter2/17_Optional_Chaining.md b/source-tw/chapter2/17_Optional_Chaining.md new file mode 100644 index 00000000..10a6755e --- /dev/null +++ b/source-tw/chapter2/17_Optional_Chaining.md @@ -0,0 +1,321 @@ +> 翻譯：[Jasonbroker](https://github.com/Jasonbroker) +> 校對：[numbbbbb](https://github.com/numbbbbb), [stanzhai](https://github.com/stanzhai) + +# Optional Chaining +----------------- + +本頁包含內容： + +- [可選鏈可替代強制解析](#optional_chaining_as_an_alternative_to_forced_unwrapping) +- [為可選鏈定義模型類](#defining_model_classes_for_optional_chaining) +- [通過可選鏈調用屬性](#calling_properties_through_optional_chaining) +- [通過可選鏈調用方法](#calling_methods_through_optional_chaining) +- [使用可選鏈調用子腳本](#calling_subscripts_through_optional_chaining) +- [連接多層鏈接](#linking_multiple_levels_of_chaining) +- [鏈接可選返回值的方法](#chaining_on_methods_with_optional_return_values) + +可選鏈（Optional Chaining）是一種可以請求和調用屬性、方法及子腳本的過程，它的可選性體現於請求或調用的目標當前可能為空（`nil`）。如果可選的目標有值，那麼調用就會成功；相反，如果選擇的目標為空（`nil`），則這種調用將返回空（`nil`）。多次請求或調用可以被鏈接在一起形成一個鏈，如果任何一個節點為空（`nil`）將導致整個鏈失效。 + +> 注意： +Swift 的可選鏈和 Objective-C 中的消息為空有些相像，但是 Swift 可以使用在任意類型中，並且失敗與否可以被檢測到。 + + +## 可選鏈可替代強制解析 + +通過在想調用的屬性、方法、或子腳本的可選值（`optional value`）（非空）後面放一個問號，可以定義一個可選鏈。這一點很像在可選值後面放一個歎號來強制拆得其封包內的值。它們的主要的區別在於當可選值為空時可選鏈即刻失敗，然而一般的強制解析將會引發運行時錯誤。 + +為了反映可選鏈可以調用空（`nil`），不論你調用的屬性、方法、子腳本等返回的值是不是可選值，它的返回結果都是一個可選值。你可以利用這個返回值來檢測你的可選鏈是否調用成功，有返回值即成功，返回nil則失敗。 + +調用可選鏈的返回結果與原本的返回結果具有相同的類型，但是原本的返回結果被包裝成了一個可選值，當可選鏈調用成功時，一個應該返回`Int`的屬性將會返回`Int?`。 + +下面幾段代碼將解釋可選鏈和強制解析的不同。 + +首先定義兩個類`Person`和`Residence`。 + +```swift +class Person { + var residence: Residence? +} + +class Residence { + var numberOfRooms = 1 +} +``` + +`Residence`具有一個`Int`類型的`numberOfRooms`，其值為 1。`Person`具有一個可選`residence`屬性，它的類型是`Residence？`。 + +如果你創建一個新的`Person`實例，它的`residence`屬性由於是被定義為可選型的，此屬性將默認初始化為空： + +```swift +let john = Person() +``` + +如果你想使用感歎號（`!`）強制解析獲得這個人`residence`屬性`numberOfRooms`屬性值，將會引發運行時錯誤，因為這時沒有可以供解析的`residence`值。 + +```swift +let roomCount = john.residence!.numberOfRooms +//將導致運行時錯誤 +``` +當`john.residence`不是`nil`時，會運行通過，且會將`roomCount` 設置為一個`int`類型的合理值。然而，如上所述，當`residence`為空時，這個代碼將會導致運行時錯誤。 + +可選鏈提供了一種另一種獲得`numberOfRooms`的方法。利用可選鏈，使用問號來代替原來`!`的位置： + +```swift +if let roomCount = john.residence?.numberOfRooms { + println("John's residence has \(roomCount) room(s).") +} else { + println("Unable to retrieve the number of rooms.") +} +// 打印 "Unable to retrieve the number of rooms. +``` + +這告訴 Swift 來鏈接可選`residence?`屬性，如果`residence`存在則取回`numberOfRooms`的值。 + +因為這種嘗試獲得`numberOfRooms`的操作有可能失敗，可選鏈會返回`Int?`類型值，或者稱作「可選`Int`」。當`residence`是空的時候（上例），選擇`Int`將會為空，因此會出先無法訪問`numberOfRooms`的情況。 + +要注意的是，即使numberOfRooms是非可選`Int`（`Int?`）時這一點也成立。只要是通過可選鏈的請求就意味著最後`numberOfRooms`總是返回一個`Int?`而不是`Int`。 + +你可以自己定義一個`Residence`實例給`john.residence`，這樣它就不再為空了： + +```swift +john.residence = Residence() +``` + +`john.residence` 現在有了實際存在的實例而不是nil了。如果你想使用和前面一樣的可選鏈來獲得`numberOfRoooms`，它將返回一個包含默認值 1 的`Int?`： + +```swift +if let roomCount = john.residence?.numberOfRooms { + println("John's residence has \(roomCount) room(s).") +} else { + println("Unable to retrieve the number of rooms.") +} +// 打印 "John's residence has 1 room(s)"。 +``` + + +##為可選鏈定義模型類 + +你可以使用可選鏈來多層調用屬性，方法，和子腳本。這讓你可以利用它們之間的複雜模型來獲取更底層的屬性，並檢查是否可以成功獲取此類底層屬性。 + +後面的代碼定義了四個將在後面使用的模型類，其中包括多層可選鏈。這些類是由上面的`Person`和`Residence`模型通過添加一個`Room`和一個`Address`類拓展來。 + +`Person`類定義與之前相同。 + +```swift +class Person { + var residence: Residence? +} +``` + +`Residence`類比之前複雜些。這次，它定義了一個變量 `rooms`，它被初始化為一個`Room[]`類型的空數組： + +```swift +class Residence { + var rooms = Room[]() + var numberOfRooms: Int { + return rooms.count + } + subscript(i: Int) -> Room { + return rooms[i] + } + func printNumberOfRooms() { + println("The number of rooms is \(numberOfRooms)") + } + var address: Address? +} +``` + +因為`Residence`存儲了一個`Room`實例的數組，它的`numberOfRooms`屬性值不是一個固定的存儲值，而是通過計算而來的。`numberOfRooms`屬性值是由返回`rooms`數組的`count`屬性值得到的。 + +為了能快速訪問`rooms`數組，`Residence`定義了一個只讀的子腳本，通過插入數組的元素角標就可以成功調用。如果該角標存在，子腳本則將該元素返回。 + +`Residence`中也提供了一個`printNumberOfRooms`的方法，即簡單的打印房間個數。 + +最後，`Residence`定義了一個可選屬性叫`address`（`address?`）。`Address`類的屬性將在後面定義。 +用於`rooms`數組的`Room`類是一個很簡單的類，它只有一個`name`屬性和一個設定`room`名的初始化器。 + +```swift +class Room { + let name: String + init(name: String) { self.name = name } +} +``` + + +這個模型中的最終類叫做`Address`。它有三個類型是`String?`的可選屬性。前面兩個可選屬性`buildingName`和 `buildingNumber`作為地址的一部分，是定義某個建築物的兩種方式。第三個屬性`street`，用於命名地址的街道名： + +```swift +class Address { + var buildingName: String? + var buildingNumber: String? + var street: String? + func buildingIdentifier() -> String? { + if buildingName { + return buildingName + } else if buildingNumber { + return buildingNumber + } else { + return nil + } + } +} +``` + +`Address`類還提供了一個`buildingIdentifier`的方法，它的返回值類型為`String?`。這個方法檢查`buildingName`和`buildingNumber`的屬性，如果`buildingName`有值則將其返回，或者如果`buildingNumber`有值則將其返回，再或如果沒有一個屬性有值，返回空。 + + +##通過可選鏈調用屬性 + +正如上面「 [可選鏈可替代強制解析](#optional_chaining_as_an_alternative_to_forced_unwrapping)」中所述，你可以利用可選鏈的可選值獲取屬性，並且檢查屬性是否獲取成功。然而，你不能使用可選鏈為屬性賦值。 + +使用上述定義的類來創建一個人實例，並再次嘗試後去它的`numberOfRooms`屬性： + +```swift +let john = Person() +if let roomCount = john.residence?.numberOfRooms { + println("John's residence has \(roomCount) room(s).") +} else { + println("Unable to retrieve the number of rooms.") +} +// 打印 "Unable to retrieve the number of rooms。 +``` + +由於`john.residence`是空，所以這個可選鏈和之前一樣失敗了，但是沒有運行時錯誤。 + + +##通過可選鏈調用方法 + +你可以使用可選鏈的來調用可選值的方法並檢查方法調用是否成功。即使這個方法沒有返回值，你依然可以使用可選鏈來達成這一目的。 + +`Residence`的`printNumberOfRooms`方法會打印`numberOfRooms`的當前值。方法如下： + +```swift +func printNumberOfRooms(){ + println(「The number of rooms is \(numberOfRooms)」) +} +``` + +這個方法沒有返回值。但是，沒有返回值類型的函數和方法有一個隱式的返回值類型`Void`（參見Function Without Return Values）。 + +如果你利用可選鏈調用此方法，這個方法的返回值類型將是`Void?`，而不是`Void`，因為當通過可選鏈調用方法時返回值總是可選類型（optional type）。即使這個方法本身沒有定義返回值，你也可以使用`if`語句來檢查是否能成功調用`printNumberOfRooms`方法：如果方法通過可選鏈調用成功，`printNumberOfRooms`的隱式返回值將會是`Void`，如果沒有成功，將返回`nil`： + +```swift +if john.residence?.printNumberOfRooms() { + println("It was possible to print the number of rooms.") +} else { + println("It was not possible to print the number of rooms.") +} +// 打印 "It was not possible to print the number of rooms."。 +``` + + +##使用可選鏈調用子腳本 + +你可以使用可選鏈來嘗試從子腳本獲取值並檢查子腳本的調用是否成功，然而，你不能通過可選鏈來設置子代碼。 + +> 注意： +當你使用可選鏈來獲取子腳本的時候，你應該將問號放在子腳本括號的前面而不是後面。可選鏈的問號一般直接跟在表達語句的後面。 + +下面這個例子用在`Residence`類中定義的子腳本來獲取`john.residence`數組中第一個房間的名字。因為`john.residence`現在是`nil`，子腳本的調用失敗了。 + +```swift +if let firstRoomName = john.residence?[0].name { + println("The first room name is \(firstRoomName).") +} else { + println("Unable to retrieve the first room name.") +} +// 打印 "Unable to retrieve the first room name."。 +``` + +在子代碼調用中可選鏈的問號直接跟在`john.residence`的後面，在子腳本括號的前面，因為`john.residence`是可選鏈試圖獲得的可選值。 + +如果你創建一個`Residence`實例給`john.residence`，且在他的`rooms`數組中有一個或多個`Room`實例，那麼你可以使用可選鏈通過`Residence`子腳本來獲取在`rooms`數組中的實例了： + +```swift +let johnsHouse = Residence() +johnsHouse.rooms += Room(name: "Living Room") +johnsHouse.rooms += Room(name: "Kitchen") +john.residence = johnsHouse + +if let firstRoomName = john.residence?[0].name { + println("The first room name is \(firstRoomName).") +} else { + println("Unable to retrieve the first room name.") +} +// 打印 "The first room name is Living Room."。 +``` + + +##連接多層鏈接 + +你可以將多層可選鏈連接在一起，可以掘取模型內更下層的屬性方法和子腳本。然而多層可選鏈不能再添加比已經返回的可選值更多的層。 +也就是說： + +如果你試圖獲得的類型不是可選類型，由於使用了可選鏈它將變成可選類型。 +如果你試圖獲得的類型已經是可選類型，由於可選鏈它也不會提高可選性。 + +因此： + +如果你試圖通過可選鏈獲得`Int`值，不論使用了多少層鏈接返回的總是`Int?`。 +相似的，如果你試圖通過可選鏈獲得`Int?`值，不論使用了多少層鏈接返回的總是`Int?`。 + +下面的例子試圖獲取`john`的`residence`屬性裡的`address`的`street`屬性。這裡使用了兩層可選鏈來聯繫`residence`和`address`屬性，它們兩者都是可選類型： + +```swift +if let johnsStreet = john.residence?.address?.street { + println("John's street name is \(johnsStreet).") +} else { + println("Unable to retrieve the address.") +} +// 打印 "Unable to retrieve the address.」。 +``` + +`john.residence`的值現在包含一個`Residence`實例，然而`john.residence.address`現在是`nil`，因此`john.residence?.address?.street`調用失敗。 + +從上面的例子發現，你試圖獲得`street`屬性值。這個屬性的類型是`String?`。因此儘管在可選類型屬性前使用了兩層可選鏈，`john.residence?.address?.street`的返回值類型也是`String?`。 + +如果你為`Address`設定一個實例來作為`john.residence.address`的值，並為`address`的`street`屬性設定一個實際值，你可以通過多層可選鏈來得到這個屬性值。 + +```swift +let johnsAddress = Address() +johnsAddress.buildingName = "The Larches" +johnsAddress.street = "Laurel Street" +john.residence!.address = johnsAddress +``` + +```swift +if let johnsStreet = john.residence?.address?.street { + println("John's street name is \(johnsStreet).") +} else { + println("Unable to retrieve the address.") +} +// 打印 "John's street name is Laurel Street."。 +``` + +值得注意的是，「`!`」符號在給`john.residence.address`分配`address`實例時的使用。`john.residence`屬性是一個可選類型，因此你需要在它獲取`address`屬性之前使用`!`解析以獲得它的實際值。 + + +##鏈接可選返回值的方法 + +前面的例子解釋了如何通過可選鏈來獲得可選類型屬性值。你也可以通過可選鏈調用一個返回可選類型值的方法並按需鏈接該方法的返回值。 + +下面的例子通過可選鏈調用了`Address`類中的`buildingIdentifier` 方法。這個方法的返回值類型是`String?`。如上所述，這個方法在可選鏈調用後最終的返回值類型依然是`String?`： + +```swift +if let buildingIdentifier = john.residence?.address?.buildingIdentifier() { + println("John's building identifier is \(buildingIdentifier).") +} +// 打印 "John's building identifier is The Larches."。 +``` + +如果你還想進一步對方法返回值執行可選鏈，將可選鏈問號符放在方法括號的後面： + +```swift +if let upper = john.residence?.address?.buildingIdentifier()?.uppercaseString { + println("John's uppercase building identifier is \(upper).") +} +// 打印 "John's uppercase building identifier is THE LARCHES."。 +``` + +> 注意： +在上面的例子中，你將可選鏈問號符放在括號後面是因為你想要鏈接的可選值是`buildingIdentifier`方法的返回值，不是`buildingIdentifier`方法本身。 diff --git a/source-tw/chapter2/18_Type_Casting.md b/source-tw/chapter2/18_Type_Casting.md new file mode 100644 index 00000000..11b353d4 --- /dev/null +++ b/source-tw/chapter2/18_Type_Casting.md @@ -0,0 +1,252 @@ +> 翻譯：[xiehurricane](https://github.com/xiehurricane) +> 校對：[happyming](https://github.com/happyming) + +# 類型轉換（Type Casting） +----------------- + +本頁包含內容： + +- [定義一個類層次作為例子](#defining_a_class_hierarchy_for_type_casting) +- [檢查類型](#checking_type) +- [向下轉型（Downcasting）](#downcasting) +- [`Any`和`AnyObject`的類型轉換](#type_casting_for_any_and_anyobject) + + +_類型轉換_是一種檢查類實例的方式，並且或者也是讓實例作為它的父類或者子類的一種方式。 + +類型轉換在 Swift 中使用`is` 和 `as`操作符實現。這兩個操作符提供了一種簡單達意的方式去檢查值的類型或者轉換它的類型。 + +你也可以用來檢查一個類是否實現了某個協議，就像在 [Checking for Protocol Conformance](Protocols.html#//apple_ref/doc/uid/TP40014097-CH25-XID_363)部分講述的一樣。 + + +## 定義一個類層次作為例子 + +你可以將它用在類和子類的層次結構上，檢查特定類實例的類型並且轉換這個類實例的類型成為這個層次結構中的其他類型。這下面的三個代碼段定義了一個類層次和一個包含了幾個這些類實例的數組，作為類型轉換的例子。 + +第一個代碼片段定義了一個新的基礎類`MediaItem`。這個類為任何出現在數字媒體庫的媒體項提供基礎功能。特別的，它聲明了一個 `String` 類型的 `name` 屬性，和一個`init name`初始化器。（它假定所有的媒體項都有個名稱。） + +```swift +class MediaItem { + var name: String + init(name: String) { + self.name = name + } +} +``` + +下一個代碼段定義了 `MediaItem` 的兩個子類。第一個子類`Movie`，在父類（或者說基類）的基礎上增加了一個 `director`（導演） 屬性，和相應的初始化器。第二個類在父類的基礎上增加了一個 `artist`（藝術家） 屬性，和相應的初始化器： + +```swift +class Movie: MediaItem { + var director: String + init(name: String, director: String) { + self.director = director + super.init(name: name) + } +} + +class Song: MediaItem { + var artist: String + init(name: String, artist: String) { + self.artist = artist + super.init(name: name) + } +} +``` + +最後一個代碼段創建了一個數組常量 `library`，包含兩個`Movie`實例和三個`Song`實例。`library`的類型是在它被初始化時根據它數組中所包含的內容推斷來的。Swift 的類型檢測器能夠演繹出`Movie` 和 `Song` 有共同的父類 `MediaItem` ，所以它推斷出 `MediaItem[]` 類作為 `library` 的類型。 + +```swift +let library = [ + Movie(name: "Casablanca", director: "Michael Curtiz"), + Song(name: "Blue Suede Shoes", artist: "Elvis Presley"), + Movie(name: "Citizen Kane", director: "Orson Welles"), + Song(name: "The One And Only", artist: "Chesney Hawkes"), + Song(name: "Never Gonna Give You Up", artist: "Rick Astley") +] +// the type of "library" is inferred to be MediaItem[] +``` + +在幕後`library` 裡存儲的媒體項依然是 `Movie` 和 `Song` 類型的，但是，若你迭代它，取出的實例會是 `MediaItem` 類型的，而不是 `Movie` 和 `Song` 類型的。為了讓它們作為它們本來的類型工作，你需要檢查它們的類型或者向下轉換它們的類型到其它類型，就像下面描述的一樣。 + + +## 檢查類型（Checking Type） + +用類型檢查操作符(`is`)來檢查一個實例是否屬於特定子類型。若實例屬於那個子類型，類型檢查操作符返回 `true` ，否則返回 `false` 。 + +下面的例子定義了兩個變量，`movieCount` 和 `songCount`，用來計算數組`library` 中 `Movie` 和 `Song` 類型的實例數量。 + +```swift +var movieCount = 0 +var songCount = 0 + +for item in library { + if item is Movie { + ++movieCount + } else if item is Song { + ++songCount + } +} + +println("Media library contains \(movieCount) movies and \(songCount) songs") +// prints "Media library contains 2 movies and 3 songs" +``` + +示例迭代了數組 `library` 中的所有項。每一次， `for`-`in` 循環設置 +`item` 為數組中的下一個 `MediaItem`。 + +若當前 `MediaItem` 是一個 `Movie` 類型的實例， `item is Movie` 返回 +`true`，相反返回 `false`。同樣的，`item is +Song`檢查item是否為`Song`類型的實例。在循環結束後，`movieCount` 和 `songCount`的值就是被找到屬於各自的類型的實例數量。 + + +## 向下轉型（Downcasting） + +某類型的一個常量或變量可能在幕後實際上屬於一個子類。你可以相信，上面就是這種情況。你可以嘗試向下轉到它的子類型，用類型轉換操作符(`as`) + +因為向下轉型可能會失敗，類型轉型操作符帶有兩種不同形式。可選形式（ optional form） `as?` 返回一個你試圖下轉成的類型的可選值（optional value）。強制形式 `as` 把試圖向下轉型和強制解包（force-unwraps）結果作為一個混合動作。 + +當你不確定向下轉型可以成功時，用類型轉換的可選形式(`as?`)。可選形式的類型轉換總是返回一個可選值（optional value），並且若下轉是不可能的，可選值將是 `nil` 。這使你能夠檢查向下轉型是否成功。 + +只有你可以確定向下轉型一定會成功時，才使用強制形式。當你試圖向下轉型為一個不正確的類型時，強制形式的類型轉換會觸發一個運行時錯誤。 + +下面的例子，迭代了`library`裡的每一個 `MediaItem` ，並打印出適當的描述。要這樣做，`item`需要真正作為`Movie` 或 `Song`的類型來使用。不僅僅是作為 `MediaItem`。為了能夠使用`Movie` 或 `Song`的 `director` 或 `artist`屬性，這是必要的。 + +在這個示例中，數組中的每一個`item`可能是 `Movie` 或 `Song`。 事前你不知道每個`item`的真實類型，所以這裡使用可選形式的類型轉換 （`as?`）去檢查循環裡的每次下轉。 + +```swift +for item in library { + if let movie = item as? Movie { + println("Movie: '\(movie.name)', dir. \(movie.director)") + } else if let song = item as? Song { + println("Song: '\(song.name)', by \(song.artist)") + } +} + +// Movie: 'Casablanca', dir. Michael Curtiz +// Song: 'Blue Suede Shoes', by Elvis Presley +// Movie: 'Citizen Kane', dir. Orson Welles +// Song: 'The One And Only', by Chesney Hawkes +// Song: 'Never Gonna Give You Up', by Rick Astley +``` + +示例首先試圖將 `item` 下轉為 `Movie`。因為 `item` 是一個 `MediaItem` +類型的實例，它可能是一個`Movie`；同樣，它可能是一個 `Song`，或者僅僅是基類 +`MediaItem`。因為不確定，`as?`形式在試圖下轉時將返還一個可選值。 `item as Movie` 的返回值是`Movie?`類型或 「optional `Movie`」。 + +當向下轉型為 `Movie` 應用在兩個 `Song` +實例時將會失敗。為了處理這種情況，上面的例子使用了可選綁定（optional binding）來檢查可選 `Movie`真的包含一個值（這個是為了判斷下轉是否成功。）可選綁定是這樣寫的「`if let movie = item as? Movie`」，可以這樣解讀： + +「嘗試將 `item` 轉為 `Movie`類型。若成功，設置一個新的臨時常量 `movie` 來存儲返回的可選`Movie`」 + +若向下轉型成功，然後`movie`的屬性將用於打印一個`Movie`實例的描述，包括它的導演的名字`director`。當`Song`被找到時，一個相近的原理被用來檢測 `Song` 實例和打印它的描述。 + +> 注意： +轉換沒有真的改變實例或它的值。潛在的根本的實例保持不變；只是簡單地把它作為它被轉換成的類來使用。 + + +## `Any`和`AnyObject`的類型轉換 + +Swift為不確定類型提供了兩種特殊類型別名： + +* `AnyObject`可以代表任何class類型的實例。 +* `Any`可以表示任何類型，除了方法類型（function types）。 + +> 注意： +只有當你明確的需要它的行為和功能時才使用`Any`和`AnyObject`。在你的代碼裡使用你期望的明確的類型總是更好的。 + +### `AnyObject`類型 + +當需要在工作中使用 Cocoa APIs，它一般接收一個`AnyObject[]`類型的數組，或者說「一個任何對像類型的數組」。這是因為 Objective-C 沒有明確的類型化數組。但是，你常常可以確定包含在僅從你知道的 API 信息提供的這樣一個數組中的對象的類型。 + +在這些情況下，你可以使用強制形式的類型轉換(`as`)來下轉在數組中的每一項到比 `AnyObject` 更明確的類型，不需要可選解析（optional unwrapping）。 + +下面的示例定義了一個 `AnyObject[]` 類型的數組並填入三個`Movie`類型的實例： + +```swift +let someObjects: AnyObject[] = [ + Movie(name: "2001: A Space Odyssey", director: "Stanley Kubrick"), + Movie(name: "Moon", director: "Duncan Jones"), + Movie(name: "Alien", director: "Ridley Scott") +] +``` + +因為知道這個數組只包含 `Movie` 實例，你可以直接用(`as`)下轉並解包到不可選的`Movie`類型（ps：其實就是我們常用的正常類型，這裡是為了和可選類型相對比）。 + +```swift +for object in someObjects { + let movie = object as Movie + println("Movie: '\(movie.name)', dir. \(movie.director)") +} +// Movie: '2001: A Space Odyssey', dir. Stanley Kubrick +// Movie: 'Moon', dir. Duncan Jones +// Movie: 'Alien', dir. Ridley Scott +``` + +為了變為一個更短的形式，下轉`someObjects`數組為`Movie[]`類型來代替下轉每一項方式。 + +```swift +for movie in someObjects as Movie[] { + println("Movie: '\(movie.name)', dir. \(movie.director)") +} +// Movie: '2001: A Space Odyssey', dir. Stanley Kubrick +// Movie: 'Moon', dir. Duncan Jones +// Movie: 'Alien', dir. Ridley Scott +``` + +### `Any`類型 + +這裡有個示例，使用 `Any` 類型來和混合的不同類型一起工作，包括非`class`類型。它創建了一個可以存儲`Any`類型的數組 `things`。 + +```swift +var things = Any[]() + +things.append(0) +things.append(0.0) +things.append(42) +things.append(3.14159) +things.append("hello") +things.append((3.0, 5.0)) +things.append(Movie(name: "Ghostbusters", director: "Ivan Reitman")) +``` + +`things` 數組包含兩個 `Int` 值，2個 `Double` 值，1個 `String` 值，一個元組 `(Double, Double)` ，Ivan Reitman 導演的電影「Ghostbusters」。 + +你可以在 `switch` `cases`裡用`is` 和 `as` 操作符來發覺只知道是 `Any` 或 `AnyObject`的常量或變量的類型。 下面的示例迭代 `things`數組中的每一項的並用`switch`語句查找每一項的類型。這幾種`switch`語句的情形綁定它們匹配的值到一個規定類型的常量，讓它們可以打印它們的值： + +```swift +for thing in things { + switch thing { + case 0 as Int: + println("zero as an Int") + case 0 as Double: + println("zero as a Double") + case let someInt as Int: + println("an integer value of \(someInt)") + case let someDouble as Double where someDouble > 0: + println("a positive double value of \(someDouble)") + case is Double: + println("some other double value that I don't want to print") + case let someString as String: + println("a string value of \"\(someString)\"") + case let (x, y) as (Double, Double): + println("an (x, y) point at \(x), \(y)") + case let movie as Movie: + println("a movie called '\(movie.name)', dir. \(movie.director)") + default: + println("something else") + } +} + +// zero as an Int +// zero as a Double +// an integer value of 42 +// a positive double value of 3.14159 +// a string value of "hello" +// an (x, y) point at 3.0, 5.0 +// a movie called 'Ghostbusters', dir. Ivan Reitman +``` + + +> 注意： +在一個switch語句的case中使用強制形式的類型轉換操作符（as, 而不是 as?）來檢查和轉換到一個明確的類型。在 switch case 語句的內容中這種檢查總是安全的。 diff --git a/source-tw/chapter2/19_Nested_Types.md b/source-tw/chapter2/19_Nested_Types.md new file mode 100644 index 00000000..ba976994 --- /dev/null +++ b/source-tw/chapter2/19_Nested_Types.md @@ -0,0 +1,97 @@ +> 翻譯：[Lin-H](https://github.com/Lin-H) +> 校對：[shinyzhu](https://github.com/shinyzhu) + +# 嵌套類型 +----------------- + +本頁包含內容： + +- [嵌套類型實例](#nested_types_in_action) +- [嵌套類型的引用](#referring_to_nested_types) + +枚舉類型常被用於實現特定類或結構體的功能。也能夠在有多種變量類型的環境中，方便地定義通用類或結構體來使用，為了實現這種功能，Swift允許你定義嵌套類型，可以在枚舉類型、類和結構體中定義支持嵌套的類型。 + +要在一個類型中嵌套另一個類型，將需要嵌套的類型的定義寫在被嵌套類型的區域{}內，而且可以根據需要定義多級嵌套。 + + +##嵌套類型實例 + +下面這個例子定義了一個結構體`BlackjackCard`(二十一點)，用來模擬`BlackjackCard`中的撲克牌點數。`BlackjackCard`結構體包含2個嵌套定義的枚舉類型`Suit` 和 `Rank`。 + +在`BlackjackCard`規則中，`Ace`牌可以表示1或者11，`Ace`牌的這一特徵用一個嵌套在枚舉型`Rank`的結構體`Values`來表示。 + +```swift +struct BlackjackCard { + // 嵌套定義枚舉型Suit + enum Suit: Character { + case Spades = "□", Hearts = "□", Diamonds = "□", Clubs = "□" + } + + // 嵌套定義枚舉型Rank + enum Rank: Int { + case Two = 2, Three, Four, Five, Six, Seven, Eight, Nine, Ten + case Jack, Queen, King, Ace + struct Values { + let first: Int, second: Int? + } + var values: Values { + switch self { + case .Ace: + return Values(first: 1, second: 11) + case .Jack, .Queen, .King: + return Values(first: 10, second: nil) + default: + return Values(first: self.toRaw(), second: nil) + } + } + } + + // BlackjackCard 的屬性和方法 + let rank: Rank, suit: Suit + var description: String { + var output = "suit is \(suit.toRaw())," + output += " value is \(rank.values.first)" + if let second = rank.values.second { + output += " or \(second)" + } + return output + } +} +``` + +枚舉型的`Suit`用來描述撲克牌的四種花色，並分別用一個`Character`類型的值代表花色符號。 + +枚舉型的`Rank`用來描述撲克牌從`Ace`~10,`J`,`Q`,`K`,13張牌，並分別用一個`Int`類型的值表示牌的面值。(這個`Int`類型的值不適用於`Ace`,`J`,`Q`,`K`的牌)。 + +如上文所提到的，枚舉型`Rank`在自己內部定義了一個嵌套結構體`Values`。這個結構體包含兩個變量，只有`Ace`有兩個數值，其餘牌都只有一個數值。結構體`Values`中定義的兩個屬性： + +`first`, 為` Int` +`second`, 為 `Int?`, 或 「optional `Int`」 + +`Rank`定義了一個計算屬性`values`，這個計算屬性會根據牌的面值，用適當的數值去初始化`Values`實例，並賦值給`values`。對於`J`,`Q`,`K`,`Ace`會使用特殊數值，對於數字面值的牌使用`Int`類型的值。 + +`BlackjackCard`結構體自身有兩個屬性—`rank`與`suit`，也同樣定義了一個計算屬性`description`，`description`屬性用`rank`和`suit`的中內容來構建對這張撲克牌名字和數值的描述，並用可選類型`second`來檢查是否存在第二個值，若存在，則在原有的描述中增加對第二數值的描述。 + +因為`BlackjackCard`是一個沒有自定義構造函數的結構體，在[Memberwise Initializers for Structure Types](https://github.com/CocoaChina-editors/Welcome-to-Swift/blob/master/The%20Swift%20Programming%20Language/02Language%20Guide/14Initialization.md)中知道結構體有默認的成員構造函數，所以你可以用默認的`initializer`去初始化新的常量`theAceOfSpades`: + +```swift +let theAceOfSpades = BlackjackCard(rank: .Ace, suit: .Spades) +println("theAceOfSpades: \(theAceOfSpades.description)") +// 打印出 "theAceOfSpades: suit is □, value is 1 or 11" +``` + +儘管`Rank`和`Suit`嵌套在`BlackjackCard`中，但仍可被引用，所以在初始化實例時能夠通過枚舉類型中的成員名稱單獨引用。在上面的例子中`description`屬性能正確得輸出對`Ace`牌有1和11兩個值。 + + +##嵌套類型的引用 + +在外部對嵌套類型的引用，以被嵌套類型的名字為前綴，加上所要引用的屬性名： + +```swift +let heartsSymbol = BlackjackCard.Suit.Hearts.toRaw() +// 紅心的符號 為 "□" +``` + +對於上面這個例子，這樣可以使`Suit`, `Rank`, 和 `Values`的名字盡可能的短，因為它們的名字會自然的由被定義的上下文來限定。 + +preview diff --git a/source-tw/chapter2/20_Extensions.md b/source-tw/chapter2/20_Extensions.md new file mode 100644 index 00000000..6f77a562 --- /dev/null +++ b/source-tw/chapter2/20_Extensions.md @@ -0,0 +1,300 @@ +> 翻譯：[lyuka](https://github.com/lyuka) +> 校對：[Hawstein](https://github.com/Hawstein) + +#擴展（Extensions） +---- + +本頁包含內容： + +- [擴展語法](#extension_syntax) +- [計算型屬性](#computed_properties) +- [構造器](#initializers) +- [方法](#methods) +- [下標](#subscripts) +- [嵌套類型](#nested_types) + +*擴展*就是向一個已有的類、結構體或枚舉類型添加新功能（functionality）。這包括在沒有權限獲取原始源代碼的情況下擴展類型的能力（即*逆向建模*）。擴展和 Objective-C 中的分類（categories）類似。（不過與Objective-C不同的是，Swift 的擴展沒有名字。） + +Swift 中的擴展可以： + +- 添加計算型屬性和計算靜態屬性 +- 定義實例方法和類型方法 +- 提供新的構造器 +- 定義下標 +- 定義和使用新的嵌套類型 +- 使一個已有類型符合某個協議 + + +>注意： +如果你定義了一個擴展向一個已有類型添加新功能，那麼這個新功能對該類型的所有已有實例中都是可用的，即使它們是在你的這個擴展的前面定義的。 + + +## 擴展語法（Extension Syntax） + +聲明一個擴展使用關鍵字`extension`： + +```swift +extension SomeType { + // 加到SomeType的新功能寫到這裡 +} +``` + +一個擴展可以擴展一個已有類型，使其能夠適配一個或多個協議（protocol）。當這種情況發生時，協議的名字應該完全按照類或結構體的名字的方式進行書寫： + +```swift +extension SomeType: SomeProtocol, AnotherProctocol { + // 協議實現寫到這裡 +} +``` + +按照這種方式添加的協議遵循者（protocol conformance）被稱之為[在擴展中添加協議遵循者](21_Protocols.html#adding_protocol_conformance_with_an_extension) + + +## 計算型屬性（Computed Properties） + +擴展可以向已有類型添加計算型實例屬性和計算型類型屬性。下面的例子向 Swift 的內建`Double`類型添加了5個計算型實例屬性，從而提供與距離單位協作的基本支持。 + +```swift +extension Double { + var km: Double { return self * 1_000.0 } + var m : Double { return self } + var cm: Double { return self / 100.0 } + var mm: Double { return self / 1_000.0 } + var ft: Double { return self / 3.28084 } +} +let oneInch = 25.4.mm +println("One inch is \(oneInch) meters") +// 打印輸出："One inch is 0.0254 meters" +let threeFeet = 3.ft +println("Three feet is \(threeFeet) meters") +// 打印輸出："Three feet is 0.914399970739201 meters" +``` + +這些計算屬性表達的含義是把一個`Double`型的值看作是某單位下的長度值。即使它們被實現為計算型屬性，但這些屬性仍可以接一個帶有dot語法的浮點型字面值，而這恰恰是使用這些浮點型字面量實現距離轉換的方式。 + +在上述例子中，一個`Double`型的值`1.0`被用來表示「1米」。這就是為什麼`m`計算型屬性返回`self`——表達式`1.m`被認為是計算`1.0`的`Double`值。 + +其它單位則需要一些轉換來表示在米下測量的值。1千米等於1,000米，所以`km`計算型屬性要把值乘以`1_000.00`來轉化成單位米下的數值。類似地，1米有3.28024英尺，所以`ft`計算型屬性要把對應的`Double`值除以`3.28024`來實現英尺到米的單位換算。 + +這些屬性是只讀的計算型屬性，所有從簡考慮它們不用`get`關鍵字表示。它們的返回值是`Double`型，而且可以用於所有接受`Double`的數學計算中： + +```swift +let aMarathon = 42.km + 195.m +println("A marathon is \(aMarathon) meters long") +// 打印輸出："A marathon is 42495.0 meters long" +``` + + +>注意： +擴展可以添加新的計算屬性，但是不可以添加存儲屬性，也不可以向已有屬性添加屬性觀測器(property observers)。 + + +## 構造器（Initializers） + +擴展可以向已有類型添加新的構造器。這可以讓你擴展其它類型，將你自己的定制類型作為構造器參數，或者提供該類型的原始實現中沒有包含的額外初始化選項。 + +擴展能向類中添加新的便利構造器，但是它們不能向類中添加新的指定構造器或析構函數。指定構造器和析構函數必須總是由原始的類實現來提供。 + +> 注意： +如果你使用擴展向一個值類型添加一個構造器，在該值類型已經向所有的存儲屬性提供默認值，而且沒有定義任何定制構造器（custom initializers）時，你可以在值類型的擴展構造器中調用默認構造器(default initializers)和逐一成員構造器(memberwise initializers)。 + +正如在值類型的構造器委託中描述的，如果你已經把構造器寫成值類型原始實現的一部分，上述規則不再適用。 + + +下面的例子定義了一個用於描述幾何矩形的定制結構體`Rect`。這個例子同時定義了兩個輔助結構體`Size`和`Point`，它們都把`0.0`作為所有屬性的默認值： + +```swift +struct Size { + var width = 0.0, height = 0.0 +} +struct Point { + var x = 0.0, y = 0.0 +} +struct Rect { + var origin = Point() + var size = Size() +} +``` + +因為結構體`Rect`提供了其所有屬性的默認值，所以正如默認構造器中描述的，它可以自動接受一個默認的構造器和一個成員級構造器。這些構造器可以用於構造新的`Rect`實例： + +```swift +let defaultRect = Rect() +let memberwiseRect = Rect(origin: Point(x: 2.0, y: 2.0), + size: Size(width: 5.0, height: 5.0)) +``` + +你可以提供一個額外的使用特殊中心點和大小的構造器來擴展`Rect`結構體： + +```swift +extension Rect { + init(center: Point, size: Size) { + let originX = center.x - (size.width / 2) + let originY = center.y - (size.height / 2) + self.init(origin: Point(x: originX, y: originY), size: size) + } +} +``` + +這個新的構造器首先根據提供的`center`和`size`值計算一個合適的原點。然後調用該結構體自動的成員構造器`init(origin:size:)`，該構造器將新的原點和大小存到了合適的屬性中： + +```swift +let centerRect = Rect(center: Point(x: 4.0, y: 4.0), + size: Size(width: 3.0, height: 3.0)) +// centerRect的原點是 (2.5, 2.5)，大小是 (3.0, 3.0) +``` + + +>注意： +如果你使用擴展提供了一個新的構造器，你依舊有責任保證構造過程能夠讓所有實例完全初始化。 + + +## 方法（Methods） + +擴展可以向已有類型添加新的實例方法和類型方法。下面的例子向`Int`類型添加一個名為`repetitions`的新實例方法： + +```swift +extension Int { + func repetitions(task: () -> ()) { + for i in 0..self { + task() + } + } +} +``` + +這個`repetitions`方法使用了一個`() -> ()`類型的單參數（single argument），表明函數沒有參數而且沒有返回值。 + +定義該擴展之後，你就可以對任意整數調用`repetitions`方法,實現的功能則是多次執行某任務： + +```swift +3.repetitions({ + println("Hello!") + }) +// Hello! +// Hello! +// Hello! +``` + +可以使用 trailing 閉包使調用更加簡潔： + +```swift +3.repetitions{ + println("Goodbye!") +} +// Goodbye! +// Goodbye! +// Goodbye! +``` + + +### 修改實例方法（Mutating Instance Methods） + +通過擴展添加的實例方法也可以修改該實例本身。結構體和枚舉類型中修改`self`或其屬性的方法必須將該實例方法標注為`mutating`，正如來自原始實現的修改方法一樣。 + +下面的例子向Swift的`Int`類型添加了一個新的名為`square`的修改方法，來實現一個原始值的平方計算： + +```swift +extension Int { + mutating func square() { + self = self * self + } +} +var someInt = 3 +someInt.square() +// someInt 現在值是 9 +``` + + +## 下標（Subscripts） + +擴展可以向一個已有類型添加新下標。這個例子向Swift內建類型`Int`添加了一個整型下標。該下標`[n]`返回十進制數字從右向左數的第n個數字 + +- 123456789[0]返回9 +- 123456789[1]返回8 + +...等等 + +```swift +extension Int { + subscript(digitIndex: Int) -> Int { + var decimalBase = 1 + for _ in 1...digitIndex { + decimalBase *= 10 + } + return (self / decimalBase) % 10 + } +} +746381295[0] +// returns 5 +746381295[1] +// returns 9 +746381295[2] +// returns 2 +746381295[8] +// returns 7 +``` + +如果該`Int`值沒有足夠的位數，即下標越界，那麼上述實現的下標會返回0，因為它會在數字左邊自動補0： + +```swift +746381295[9] +//returns 0, 即等同於： +0746381295[9] +``` + + +## 嵌套類型（Nested Types） + +擴展可以向已有的類、結構體和枚舉添加新的嵌套類型： + +```swift +extension Character { + enum Kind { + case Vowel, Consonant, Other + } + var kind: Kind { + switch String(self).lowercaseString { + case "a", "e", "i", "o", "u": + return .Vowel + case "b", "c", "d", "f", "g", "h", "j", "k", "l", "m", + "n", "p", "q", "r", "s", "t", "v", "w", "x", "y", "z": + return .Consonant + default: + return .Other + } + } +} +``` + +該例子向`Character`添加了新的嵌套枚舉。這個名為`Kind`的枚舉表示特定字符的類型。具體來說，就是表示一個標準的拉丁腳本中的字符是元音還是輔音（不考慮口語和地方變種），或者是其它類型。 + +這個例子還向`Character`添加了一個新的計算實例屬性，即`kind`，用來返回合適的`Kind`枚舉成員。 + +現在，這個嵌套枚舉可以和一個`Character`值聯合使用了： + +```swift +func printLetterKinds(word: String) { + println("'\\(word)' is made up of the following kinds of letters:") + for character in word { + switch character.kind { + case .Vowel: + print("vowel ") + case .Consonant: + print("consonant ") + case .Other: + print("other ") + } + } + print("\n") +} +printLetterKinds("Hello") +// 'Hello' is made up of the following kinds of letters: +// consonant vowel consonant consonant vowel +``` + +函數`printLetterKinds`的輸入是一個`String`值並對其字符進行迭代。在每次迭代過程中，考慮當前字符的`kind`計算屬性，並打印出合適的類別描述。所以`printLetterKinds`就可以用來打印一個完整單詞中所有字母的類型，正如上述單詞`"hello"`所展示的。 + +>注意： +由於已知`character.kind`是`Character.Kind`型，所以`Character.Kind`中的所有成員值都可以使用`switch`語句裡的形式簡寫，比如使用 `.Vowel`代替`Character.Kind.Vowel` + diff --git a/source-tw/chapter2/21_Protocols.md b/source-tw/chapter2/21_Protocols.md new file mode 100644 index 00000000..a8eab7e0 --- /dev/null +++ b/source-tw/chapter2/21_Protocols.md @@ -0,0 +1,732 @@ +> 翻譯：[geek5nan](https://github.com/geek5nan) +> 校對：[dabing1022](https://github.com/dabing1022) + +# 協議 +----------------- + +本頁包含內容： + +- [協議的語法（Protocol Syntax）](#protocol_syntax) +- [對屬性的規定（Property Requirements）](#property_requirements) +- [對方法的規定（Method Requirements）](#method_requirements) +- [對突變方法的的規定（Mutating Method Requirements）](#mutating_method_requirements) +- [協議類型（Protocols as Types）](#protocols_as_types) +- [委託(代理)模式（Delegation）](#delegation) +- [在擴展中添加協議成員（Adding Protocol Conformance with an Extension）](#adding_protocol_conformance_with_an_extension) +- [通過擴展補充協議聲明（Declaring Protocol Adoption with an Extension）](#declaring_protocol_adoption_with_an_extension) +- [集合中的協議類型（Collections of Protocol Types）](#collections_of_protocol_types) +- [協議的繼承（Protocol Inheritance）](#protocol_inheritance) +- [協議合成（Protocol Composition）](#protocol_composition) +- [檢驗協議的一致性（Checking for Protocol Conformance）](#checking_for_protocol_conformance) +- [對可選協議的規定（Optional Protocol Requirements）](#optional_protocol_requirements) + +`協議(Protocol)`用於定義完成某項任務或功能所必須的方法和屬性，協議實際上並不提供這些功能或任務的具體`實現(Implementation)`--而只用來描述這些實現應該是什麼樣的。類，結構體，枚舉通過提供協議所要求的方法，屬性的具體實現來`採用(adopt)`協議。任意能夠滿足協議要求的類型被稱為協議的`遵循者`。 + +`協議`可以要求其`遵循者`提供特定的實例屬性，實例方法，類方法，操作符或`下標(subscripts)`等。 + + +## 協議的語法 + +`協議`的定義方式與`類，結構體，枚舉`的定義都非常相似，如下所示: + +```swift +protocol SomeProtocol { + // 協議內容 +} +``` + +在類型名稱後加上`協議名稱`，中間以冒號`:`分隔即可實現協議；實現多個協議時，各協議之間用逗號`,`分隔，如下所示: + +```swift +struct SomeStructure: FirstProtocol, AnotherProtocol { + // 結構體內容 +} +``` + +如果一個類在含有`父類`的同時也採用了協議，應當把`父類`放在所有的`協議`之前，如下所示: + +```swift +class SomeClass: SomeSuperClass, FirstProtocol, AnotherProtocol { + // 類的內容 +} +``` + + +## 對屬性的規定 + +協議可以規定其`遵循者`提供特定名稱與類型的`實例屬性(instance property)`或`類屬性(type property)`，而不管其是`存儲型屬性(stored property)`還是`計算型屬性(calculate property)`。此外也可以指定屬性是只讀的還是可讀寫的。 + +如果協議要求屬性是可讀寫的，那麼這個屬性不能是常量`存儲型屬性`或只讀`計算型屬性`；如果協議要求屬性是只讀的(gettable)，那麼`計算型屬性`或`存儲型屬性`都能滿足協議對屬性的規定，在你的代碼中，即使為只讀屬性實現了寫方法(settable)也依然有效。 + +協議中的屬性經常被加以`var`前綴聲明其為變量屬性，在聲明後加上`{ set get }`來表示屬性是可讀寫的，只讀的屬性則寫作`{ get }`，如下所示: + +```swift +protocol SomeProtocol { + var musBeSettable : Int { get set } + var doesNotNeedToBeSettable: Int { get } +} +``` + +如下所示，通常在協議的定義中使用`class`前綴表示該屬性為類成員；在枚舉和結構體實現協議時中，需要使用`static`關鍵字作為前綴。 + +```swift +protocol AnotherProtocol { + class var someTypeProperty: Int { get set } +} + +如下所示，這是一個含有一個實例屬性要求的協議: + +protocol FullyNamed { + var fullName: String { get } +} +``` + +`FullyNamed`協議定義了任何擁有`fullName`的類型。它並不指定具體類型，而只是要求類型必須提供一個`fullName`。任何`FullyNamed`類型都得有一個只讀的`fullName`屬性，類型為`String`。 + +如下所示，這是一個實現了`FullyNamed`協議的簡單結構體: + +```swift +struct Person: FullyNamed{ + var fullName: String +} +let john = Person(fullName: "John Appleseed") +//john.fullName 為 "John Appleseed" +``` + +這個例子中定義了一個叫做`Person`的結構體，用來表示具有指定名字的人。從第一行代碼中可以看出，它採用了`FullyNamed`協議。 + +`Person`結構體的每一個實例都有一個叫做`fullName`，`String`類型的存儲型屬性，這正好匹配了`FullyNamed`協議的要求，也就意味著，`Person`結構體完整的`遵循`了協議。(如果協議要求未被完全滿足,在編譯時會報錯) + +這有一個更為複雜的類，它採用並實現了`FullyNamed`協議，如下所示: + +```swift +class Starship: FullyNamed { + var prefix: String? + var name: String + init(name: String, prefix: String? = nil ) { + self.anme = name + self.prefix = prefix + } + var fullName: String { + return (prefix ? prefix ! + " " : " ") + name + } +} +var ncc1701 = Starship(name: "Enterprise", prefix: "USS") +// ncc1701.fullName == "USS Enterprise" +``` + +`Starship`類把`fullName`屬性實現為只讀的`計算型屬性`。每一個`Starship`類的實例都有一個名為`name`的必備屬性和一個名為`prefix`的可選屬性。 當`prefix`存在時，將`prefix`插入到`name`之前來為`Starship`構建`fullName`，`prefix`不存在時，則將直接用`name`構建`fullName` + + +## 對方法的規定 + +`協議`可以要求其`遵循者`實現某些指定的`實例方法`或`類方法`。這些方法作為協議的一部分，像普通的方法一樣清晰的放在協議的定義中，而不需要大括號和方法體。 + +>注意： +>協議中的方法支持`變長參數(variadic parameter)`，不支持`參數默認值(default value)`。 + +如下所示，協議中類方法的定義與類屬性的定義相似，在協議定義的方法前置`class`關鍵字來表示。當在`枚舉`或`結構體`實現類方法時，需要使用`static`關鍵字來代替。 + +```swift +protocol SomeProtocol { + class func someTypeMethod() +} +``` + +如下所示，定義了含有一個實例方法的的協議。 + +``` +protocol RandomNumberGenerator { + func random() -> Double +} +``` + +`RandomNumberGenerator`協議要求其`遵循者`必須擁有一個名為`random`， 返回值類型為`Double`的實例方法。 (儘管這裡並未指明，但是我們假設返回值在[0，1]區間內)。 + +`RandomNumberGenerator`協議並不在意每一個隨機數是怎樣生成的，它只強調這裡有一個隨機數生成器。 + +如下所示，下邊的是一個遵循了`RandomNumberGenerator`協議的類。該類實現了一個叫做*線性同餘生成器(linear congruential generator)*的偽隨機數算法。 + + +```swift +class LinearCongruentialGenerator: RandomNumberGenerator { + var lastRandom = 42.0 + let m = 139968.0 + let a = 3877.0 + let c = 29573.0 + func random() -> Double { + lastRandom = ((lastRandom * a + c) % m) + return lastRandom / m + } +} +let generator = LinearCongruentialGenerator() +println("Here's a random number: \(generator.random())") +// 輸出 : "Here's a random number: 0.37464991998171" +println("And another one: \(generator.random())") +// 輸出 : "And another one: 0.729023776863283" +``` + + +## 對突變方法的規定 + +有時不得不在方法中更改實例的所屬類型。在基於`值類型(value types)`(結構體，枚舉)的實例方法中，將`mutating`關鍵字作為函數的前綴，寫在`func`之前，表示可以在該方法中修改實例及其屬性的所屬類型。這一過程在[Modifyting Value Types from Within Instance Methods](1)章節中有詳細描述。 + +如果協議中的實例方法打算改變其`遵循者`實例的類型，那麼在協議定義時需要在方法前加`mutating`關鍵字，才能使`結構體，枚舉`來採用並滿足協議中對方法的規定。 + + +>注意: +>用`類`實現協議中的`mutating`方法時，不用寫`mutating`關鍵字;用`結構體`，`枚舉`實現協議中的`mutating`方法時，必須寫`mutating`關鍵字。 + +如下所示，`Togglable`協議含有名為`toggle`的突變實例方法。根據名稱推測，`toggle`方法應該是用於切換或恢復其`遵循者`實例或其屬性的類型。 + +```swift +protocol Togglable { + mutating func toggle() +} +``` + +當使用`枚舉`或`結構體`來實現`Togglabl`協議時，需要提供一個帶有`mutating`前綴的`toggle`方法。 + +如下所示，`OnOffSwitch`枚舉`遵循`了`Togglable`協議，`On`，`Off`兩個成員用於表示當前狀態。枚舉的`toggle`方法被標記為`mutating`，用以匹配`Togglabel`協議的規定。 + +```swift +enum OnOffSwitch: Togglable { + case Off, On + mutating func toggle() { + switch self { + case Off: + self = On + case On: + self = Off + } + } +} +var lightSwitch = OnOffSwitch.Off +lightSwitch.toggle() +//lightSwitch 現在的值為 .On +``` + + +## 協議類型 + +儘管`協議`本身並不實現任何功能，但是`協議`可以被當做類型來使用。 + +使用場景: + +* `協議類型`作為函數、方法或構造器中的參數類型或返回值類型 +* `協議類型`作為常量、變量或屬性的類型 +* `協議類型`作為數組、字典或其他容器中的元素類型 + +> 注意: 協議是一種類型，因此協議類型的名稱應與其他類型(Int，Double，String)的寫法相同，使用駝峰式寫法 + +如下所示，這個示例中將協議當做類型來使用 + +```swift +class Dice { + let sides: Int + let generator: RandomNumberGenerator + init(sides: Int, generator: RandomNumberGenerator) { + self.sides = sides + self.generator = generator + } + func roll() -> Int { + return Int(generator.random() * Double(sides)) +1 + } +} +``` + +例子中又一個`Dice`類，用來代表桌游中的擁有N個面的骰子。`Dice`的實例含有`sides`和`generator`兩個屬性，前者是整型，用來表示骰子有幾個面，後者為骰子提供一個隨機數生成器。 + + `generator`屬性的類型為`RandomNumberGenerator`，因此任何遵循了`RandomNumberGenerator`協議的類型的實例都可以賦值給`generator`，除此之外，無其他要求。 + +`Dice`類中也有一個`構造器(initializer)`，用來進行初始化操作。構造器中含有一個名為`generator`，類型為`RandomNumberGenerator`的形參。在調用構造方法時創建`Dice`的實例時，可以傳入任何遵循`RandomNumberGenerator`協議的實例給generator。 + +`Dice`類也提供了一個名為`roll`的實例方法用來模擬骰子的面值。它先使用`generator`的`random`方法來創建一個[0-1]區間內的隨機數種子，然後加工這個隨機數種子生成骰子的面值。generator被認為是遵循了`RandomNumberGenerator`的類型，因而保證了`random`方法可以被調用。 + +如下所示，這裡展示了如何使用`LinearCongruentialGenerator`的實例作為隨機數生成器創建一個六面骰子: + +```swift +var d6 = Dice(sides: 6,generator: LinearCongruentialGenerator()) +for _ in 1...5 { + println("Random dice roll is \(d6.roll())") +} +//輸出結果 +//Random dice roll is 3 +//Random dice roll is 5 +//Random dice roll is 4 +//Random dice roll is 5 +//Random dice roll is 4 +``` + + +## 委託(代理)模式 + +委託是一種設計模式(*譯者注: 想起了那年 UITableViewDelegate 中的奔跑，那是我逝去的Objective-C。。。*)，它允許`類`或`結構體`將一些需要它們負責的功能`交由(委託)`給其他的類型的實例。 + +委託模式的實現很簡單: 定義`協議`來`封裝`那些需要被委託的`函數和方法`， 使其`遵循者`擁有這些被委託的`函數和方法`。 + +委託模式可以用來響應特定的動作或接收外部數據源提供的數據，而無需要知道外部數據源的所屬類型(*譯者注:只要求外部數據源`遵循`某協議*)。 + +下文是兩個基於骰子遊戲的協議: + +```swift +protocol DiceGame { + var dice: Dice { get } + func play() +} + +protocol DiceGameDelegate { + func gameDidStart(game: DiceGame) + func game(game: DiceGame, didStartNewTurnWithDiceRoll diceRoll:Int) + func gameDidEnd(game: DiceGame) +} +``` + +`DiceGame`協議可以在任意含有骰子的遊戲中實現，`DiceGameDelegate`協議可以用來追蹤`DiceGame`的遊戲過程 + +如下所示，`SnakesAndLadders`是`Snakes and Ladders`(譯者注:[Control Flow](2)章節有該遊戲的詳細介紹)遊戲的新版本。新版本使用`Dice`作為骰子，並且實現了`DiceGame`和`DiceGameDelegate`協議，後者用來記錄遊戲的過程: + +```swift +class SnakesAndLadders: DiceGame { + let finalSquare = 25 + let dic = Dice(sides: 6, generator: LinearCongruentialGenerator()) + var square = 0 + var board: Int[] + init() { + board = Int[](count: finalSquare + 1, repeatedValue: 0) + board[03] = +08; board[06] = +11; borad[09] = +09; board[10] = +02 + borad[14] = -10; board[19] = -11; borad[22] = -02; board[24] = -08 + } + var delegate: DiceGameDelegate? + func play() { + square = 0 + delegate?.gameDidStart(self) + gameLoop: while square != finalSquare { + let diceRoll = dice.roll() + delegate?.game(self,didStartNewTurnWithDiceRoll: diceRoll) + switch square + diceRoll { + case finalSquare: + break gameLoop + case let newSquare where newSquare > finalSquare: + continue gameLoop + default: + square += diceRoll + square += board[square] + } + } + delegate?.gameDIdEnd(self) + } +} +``` + +這個版本的遊戲封裝到了`SnakesAndLadders`類中，該類採用了`DiceGame`協議，並且提供了`dice`屬性和`play`實例方法用來`遵循`協議。(`dice`屬性在構造之後就不在改變，且協議只要求`dice`為只讀的，因此將`dice`聲明為常量屬性。) + +在`SnakesAndLadders`類的`構造器(initializer)`初始化遊戲。所有的遊戲邏輯被轉移到了`play`方法中，`play`方法使用協議規定的`dice`屬性提供骰子搖出的值。 + +> 注意:`delegate`並不是遊戲的必備條件，因此`delegate`被定義為遵循`DiceGameDelegate`協議的可選屬性，`delegate`使用`nil`作為初始值。 + +`DicegameDelegate`協議提供了三個方法用來追蹤遊戲過程。被放置於遊戲的邏輯中，即`play()`方法內。分別在遊戲開始時，新一輪開始時，遊戲結束時被調用。 + +因為`delegate`是一個遵循`DiceGameDelegate`的可選屬性，因此在`play()`方法中使用了`可選鏈`來調用委託方法。 若`delegate`屬性為`nil`， 則delegate所調用的方法失效。若`delegate`不為`nil`，則方法能夠被調用 + +如下所示，`DiceGameTracker`遵循了`DiceGameDelegate`協議 + +```swift +class DiceGameTracker: DiceGameDelegate { + var numberOfTurns = 0 + func gameDidStart(game: DiceGame) { + numberOfTurns = 0 + if game is SnakesAndLadders { + println("Started a new game of Snakes and Ladders") + } + println("The game is using a \(game.dice.sides)-sided dice") + } + func game(game: DiceGame, didStartNewTurnWithDiceRoll diceRoll: Int) { + ++numberOfTurns + println("Rolled a \(diceRoll)") + } + func gameDidEnd(game: DiceGame) { + println("The game lasted for \(numberOfTurns) turns") + } +} +``` + +`DiceGameTracker`實現了`DiceGameDelegate`協議規定的三個方法，用來記錄遊戲已經進行的輪數。 當遊戲開始時，`numberOfTurns`屬性被賦值為0; 在每新一輪中遞加; 遊戲結束後，輸出打印遊戲的總輪數。 + +`gameDidStart`方法從`game`參數獲取遊戲信息並輸出。`game`在方法中被當做`DiceGame`類型而不是`SnakeAndLadders`類型，所以方法中只能訪問`DiceGame`協議中的成員。 + +`DiceGameTracker`的運行情況，如下所示: + +```swift +let tracker = DiceGameTracker() +let game = SnakesAndLadders() +game.delegate = tracker +game.play() +// Started a new game of Snakes and Ladders +// The game is using a 6-sided dice +// Rolled a 3 +// Rolled a 5 +// Rolled a 4 +// Rolled a 5 +// The game lasted for 4 turns +``` + + +## 在擴展中添加協議成員 + +即便無法修改源代碼，依然可以通過`擴展(Extension)`來擴充已存在類型(*譯者注: 類，結構體，枚舉等*)。`擴展`可以為已存在的類型添加`屬性`，`方法`，`下標`，`協議`等成員。詳情請在[擴展](4)章節中查看。 + +> 注意: 通過`擴展`為已存在的類型`遵循`協議時，該類型的所有實例也會隨之添加協議中的方法 + +`TextRepresentable`協議含有一個`asText`，如下所示： + +```swift +protocol TextRepresentable { + func asText() -> String +} +``` + +通過`擴展`為上一節中提到的`Dice`類遵循`TextRepresentable`協議 + +```swift +extension Dice: TextRepresentable { + func asText() -> String { + return "A \(sides)-sided dice" + } +} +``` + +從現在起，`Dice`類型的實例可被當作`TextRepresentable`類型： + +```swift +let d12 = Dice(sides: 12,generator: LinearCongruentialGenerator()) +println(d12.asText()) +// 輸出 "A 12-sided dice" +``` + +`SnakesAndLadders`類也可以通過`擴展`的方式來遵循協議： + +```swift +extension SnakeAndLadders: TextRepresentable { + func asText() -> String { + return "A game of Snakes and Ladders with \(finalSquare) squares" + } +} +println(game.asText()) +// 輸出 "A game of Snakes and Ladders with 25 squares" +``` + + +## 通過擴展補充協議聲明 + +當一個類型已經實現了協議中的所有要求，卻沒有聲明時，可以通過`擴展`來補充協議聲明: + +```swift +struct Hamster { + var name: String + func asText() -> String { + return "A hamster named \(name)" + } +} +extension Hamster: TextRepresentable {} +``` + +從現在起，`Hamster`的實例可以作為`TextRepresentable`類型使用 + +```swift +let simonTheHamster = Hamster(name: "Simon") +let somethingTextRepresentable: TextRepresentable = simonTheHamester +println(somethingTextRepresentable.asText()) +// 輸出 "A hamster named Simon" +``` + +> 注意: 即時滿足了協議的所有要求，類型也不會自動轉變，因此你必須為它做出明顯的協議聲明 + + +## 集合中的協議類型 + +協議類型可以被集合使用，表示集合中的元素均為協議類型: + +```swift +let things: TextRepresentable[] = [game,d12,simoTheHamster] +``` + +如下所示，`things`數組可以被直接遍歷，並調用其中元素的`asText()`函數: + +```swift +for thing in things { + println(thing.asText()) +} +// A game of Snakes and Ladders with 25 squares +// A 12-sided dice +// A hamster named Simon +``` + +`thing`被當做是`TextRepresentable`類型而不是`Dice`，`DiceGame`，`Hamster`等類型。因此能且僅能調用`asText`方法 + + +## 協議的繼承 + +協議能夠繼承一到多個其他協議。語法與類的繼承相似，多個協議間用逗號`，`分隔 + +```swift +protocol InheritingProtocol: SomeProtocol, AnotherProtocol { + // 協議定義 +} +``` + +如下所示，`PrettyTextRepresentable`協議繼承了`TextRepresentable`協議 + +```swift +protocol PrettyTextRepresentable: TextRepresentable { + func asPrettyText() -> String +} +``` + +遵循`PrettyTextRepresentable`協議的同時，也需要遵循`TextRepresentable`協議。 + +如下所示，用`擴展`為`SnakesAndLadders`遵循`PrettyTextRepresentable`協議: + +```swift +extension SnakesAndLadders: PrettyTextRepresentable { + func asPrettyText() -> String { + var output = asText() + ":\n" + for index in 1...finalSquare { + switch board[index] { + case let ladder where ladder > 0: + output += "▲ " + case let snake where snake < 0: + output += "▼ " + default: + output += "○ " + } + } + return output + } +} +``` + +在`for in`中迭代出了`board`數組中的每一個元素: + +* 當從數組中迭代出的元素的值大於0時，用`▲`表示 +* 當從數組中迭代出的元素的值小於0時，用`▼`表示 +* 當從數組中迭代出的元素的值等於0時，用`○`表示 + +任意`SankesAndLadders`的實例都可以使用`asPrettyText()`方法。 + +```swift +println(game.asPrettyText()) +// A game of Snakes and Ladders with 25 squares: +// ○ ○ ▲ ○ ○ ▲ ○ ○ ▲ ▲ ○ ○ ○ ▼ ○ ○ ○ ○ ▼ ○ ○ ▼ ○ ▼ ○ +``` + + +## 協議合成 + +一個協議可由多個協議採用`protocol`這樣的格式進行組合，稱為`協議合成(protocol composition)`。 + +舉個例子： + +```swift +protocol Named { + var name: String { get } +} +protocol Aged { + var age: Int { get } +} +struct Person: Named, Aged { + var name: String + var age: Int +} +func wishHappyBirthday(celebrator: protocol) { + println("Happy birthday \(celebrator.name) - you're \(celebrator.age)!") +} +let birthdayPerson = Person(name: "Malcolm", age: 21) +wishHappyBirthday(birthdayPerson) +// 輸出 "Happy birthday Malcolm - you're 21! +``` + +`Named`協議包含`String`類型的`name`屬性;`Aged`協議包含`Int`類型的`age`屬性。`Person`結構體`遵循`了這兩個協議。 + +`wishHappyBirthday`函數的形參`celebrator`的類型為`protocol`。可以傳入任意`遵循`這兩個協議的類型的實例 + +> 注意: `協議合成`並不會生成一個新協議類型，而是將多個協議合成為一個臨時的協議，超出範圍後立即失效。 + + +## 檢驗協議的一致性 + +使用`is`和`as`操作符來檢查協議的一致性或轉化協議類型。檢查和轉化的語法和之前相同(*詳情查看[Typy Casting章節](5)*): + +* `is`操作符用來檢查實例是否`遵循`了某個`協議`。 +* `as?`返回一個可選值，當實例`遵循`協議時，返回該協議類型;否則返回`nil` +* `as`用以強制向下轉型。 + +```swift +@objc protocol HasArea { + var area: Double { get } +} +``` + +> 注意: `@objc`用來表示協議是可選的，也可以用來表示暴露給`Objective-C`的代碼，此外，`@objc`型協議只對`類`有效，因此只能在`類`中檢查協議的一致性。詳情查看*[Using Siwft with Cocoa and Objectivei-c](https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/BuildingCocoaApps/index.html#//apple_ref/doc/uid/TP40014216)*。 + +如下所示，定義了`Circle`和`Country`類，它們都遵循了`haxArea`協議 + +```swift +class Circle: HasArea { + let pi = 3.1415927 + var radius: Double + var area: Double { return pi * radius * radius } + init(radius: Double) { self.radius = radius } +} +class Country: HasArea { + var area: Double + init(area: Double) { self.area = area } +} +``` + +`Circle`類把`area`實現為基於`存儲型屬性`radius的`計算型屬性`，`Country`類則把`area`實現為`存儲型屬性`。這兩個類都`遵循`了`haxArea`協議。 + +如下所示，Animal是一個沒有實現`HasArea`協議的類 + +```swift +class Animal { + var legs: Int + init(legs: Int) { self.legs = legs } +} +``` + +`Circle，Country，Animal`並沒有一個相同的基類，因而採用`AnyObject`類型的數組來裝載在他們的實例，如下所示: + +```swift +let objects: AnyObject[] = [ + Circle(radius: 2.0), + Country(area: 243_610), + Animal(legs: 4) +] +``` + +`objects`數組使用字面量初始化，數組包含一個`radius`為2。0的`Circle`的實例，一個保存了英國面積的`Country`實例和一個`legs`為4的`Animal`實例。 + +如下所示，`objects`數組可以被迭代，對迭代出的每一個元素進行檢查，看它是否遵循`了`HasArea`協議: + +```swift +for object in objects { + if let objectWithArea = object as? HasArea { + println("Area is \(objectWithArea.area)") + } else { + println("Something that doesn't have an area") + } +} +// Area is 12.5663708 +// Area is 243610.0 +// Something that doesn't have an area +``` + +當迭代出的元素遵循`HasArea`協議時，通過`as?`操作符將其`可選綁定(optional binding)`到`objectWithArea`常量上。`objectWithArea`是`HasArea`協議類型的實例，因此`area`屬性是可以被訪問和打印的。 + +`objects`數組中元素的類型並不會因為`向下轉型`而改變，它們仍然是`Circle`，`Country`，`Animal`類型。然而，當它們被賦值給`objectWithArea`常量時，則只被視為`HasArea`類型，因此只有`area`屬性能夠被訪問。 + + +## 對可選協議的規定 + +可選協議含有可選成員，其`遵循者`可以選擇是否實現這些成員。在協議中使用`@optional`關鍵字作為前綴來定義可選成員。 + +可選協議在調用時使用`可選鏈`，詳細內容在[Optional Chaning](7)章節中查看。 + +像`someOptionalMethod?(someArgument)`這樣，你可以在可選方法名稱後加上`?`來檢查該方法是否被實現。`可選方法`和`可選屬性`都會返回一個`可選值(optional value)`，當其不可訪問時，`?`之後語句不會執行，並整體返回`nil` + +> 注意: 可選協議只能在含有`@objc`前綴的協議中生效。且`@objc`的協議只能被`類`遵循 + +如下所示，`Counter`類使用含有兩個可選成員的`CounterDataSource`協議類型的外部數據源來提供`增量值(increment amount)` + +```swift +@objc protocol CounterDataSource { + @optional func incrementForCount(count: Int) -> Int + @optional var fixedIncrement: Int { get } +} +``` + +`CounterDataSource`含有`incrementForCount`的`可選方法`和`fiexdIncrement`的`可選屬性`，它們使用了不同的方法來從數據源中獲取合適的增量值。 + +> 注意: `CounterDataSource`中的屬性和方法都是可選的，因此可以在類中聲明但不實現這些成員，儘管技術上允許這樣做，不過最好不要這樣寫。 + +`Counter`類含有`CounterDataSource?`類型的可選屬性`dataSource`，如下所示: + +```swift +@objc class Counter { + var count = 0 + var dataSource: CounterDataSource? + func increment() { + if let amount = dataSource?.incrementForCount?(count) { + count += amount + } else if let amount = dataSource?.fixedIncrement? { + count += amount + } + } +} +``` + +`count`屬性用於存儲當前的值，`increment`方法用來為`count`賦值。 + +`increment`方法通過`可選鏈`，嘗試從兩種`可選成員`中獲取`count`。 + +1. 由於`dataSource`可能為`nil`，因此在`dataSource`後邊加上了`?`標記來表明只在`dataSource`非空時才去調用`incrementForCount`方法。 + +2. 即使`dataSource`存在，但是也無法保證其是否實現了`incrementForCount`方法，因此在`incrementForCount`方法後邊也加有`?`標記 + +在調用`incrementForCount`方法後，`Int`型`可選值`通過`可選綁定(optional binding)`自動拆包並賦值給常量`amount`。 + +當`incrementForCount`不能被調用時，嘗試使用可選屬性`fixedIncrement`來代替。 + +`ThreeSource`實現了`CounterDataSource`協議，如下所示: + + class ThreeSource: CounterDataSource { + let fixedIncrement = 3 + } + +使用`ThreeSource`作為數據源開實例化一個`Counter`: + +```swift +var counter = Counter() +counter.dataSource = ThreeSource() +for _ in 1...4 { + counter.increment() + println(counter.count) +} +// 3 +// 6 +// 9 +// 12 +``` + +`TowardsZeroSource`實現了`CounterDataSource`協議中的`incrementForCount`方法，如下所示: + +```swift +class TowardsZeroSource: CounterDataSource { +func incrementForCount(count: Int) -> Int { + if count == 0 { + return 0 + } else if count < 0 { + return 1 + } else { + return -1 + } + } +} +``` + +下邊是執行的代碼： + +```swift +counter.count = -4 +counter.dataSource = TowardsZeroSource() +for _ in 1...5 { + counter.increment() + println(counter.count) +} +// -3 +// -2 +// -1 +// 0 +// 0 +``` diff --git a/source-tw/chapter2/22_Generics.md b/source-tw/chapter2/22_Generics.md new file mode 100644 index 00000000..0772f022 --- /dev/null +++ b/source-tw/chapter2/22_Generics.md @@ -0,0 +1,518 @@ + +> 翻譯：[takalard](https://github.com/takalard) +> 校對：[lifedim](https://github.com/lifedim) + +# 泛型 + +------ + +本頁包含內容： + +- [泛型所解決的問題](#the_problem_that_generics_solve) +- [泛型函數](#generic_functions) +- [類型參數](#type_parameters) +- [命名類型參數](#naming_type_parameters) +- [泛型類型](#generic_types) +- [類型約束](#type_constraints) +- [關聯類型](#associated_types) +- [`Where`語句](#where_clauses) + +*泛型代碼*可以讓你寫出根據自我需求定義、適用於任何類型的，靈活且可重用的函數和類型。它的可以讓你避免重複的代碼，用一種清晰和抽像的方式來表達代碼的意圖。 + +泛型是 Swift 強大特徵中的其中一個，許多 Swift 標準庫是通過泛型代碼構建出來的。事實上，泛型的使用貫穿了整本語言手冊，只是你沒有發現而已。例如，Swift 的數組和字典類型都是泛型集。你可以創建一個`Int`數組，也可創建一個`String`數組，或者甚至於可以是任何其他 Swift 的類型數據數組。同樣的，你也可以創建存儲任何指定類型的字典（dictionary），而且這些類型可以是沒有限制的。 + + +## 泛型所解決的問題 + +這裡是一個標準的，非泛型函數`swapTwoInts`,用來交換兩個Int值： + +```swift +func swapTwoInts(inout a: Int, inout b: Int) + let temporaryA = a + a = b + b = temporaryA +} +``` + +這個函數使用寫入讀出（in-out）參數來交換`a`和`b`的值，請參考[寫入讀出參數](../chapter2/06_Functions.html)。 + +`swapTwoInts`函數可以交換`b`的原始值到`a`，也可以交換a的原始值到`b`，你可以調用這個函數交換兩個`Int`變量值： + +```swift +var someInt = 3 +var anotherInt = 107 +swapTwoInts(&someInt, &anotherInt) +println("someInt is now \(someInt), and anotherInt is now \(anotherInt)") +// 輸出 "someInt is now 107, and anotherInt is now 3" +``` + + +`swapTwoInts`函數是非常有用的，但是它只能交換`Int`值，如果你想要交換兩個`String`或者`Double`，就不得不寫更多的函數，如 `swapTwoStrings`和`swapTwoDoublesfunctions `，如同如下所示： + +```swift +func swapTwoStrings(inout a: String, inout b: String) { + let temporaryA = a + a = b + b = temporaryA +} + +func swapTwoDoubles(inout a: Double, inout b: Double) { + let temporaryA = a + a = b + b = temporaryA +} +``` + +你可能注意到 `swapTwoInts`、 `swapTwoStrings`和`swapTwoDoubles`函數功能都是相同的，唯一不同之處就在於傳入的變量類型不同，分別是`Int`、`String`和`Double`。 + +但實際應用中通常需要一個用處更強大並且盡可能的考慮到更多的靈活性單個函數，可以用來交換兩個任何類型值，很幸運的是，泛型代碼幫你解決了這種問題。（一個這種泛型函數後面已經定義好了。） + +>注意： +在所有三個函數中，`a`和`b`的類型是一樣的。如果`a`和`b`不是相同的類型，那它們倆就不能互換值。Swift 是類型安全的語言，所以它不允許一個`String`類型的變量和一個`Double`類型的變量互相交換值。如果一定要做，Swift 將報編譯錯誤。 + + +## 泛型函數 + +`泛型函數`可以工作於任何類型，這裡是一個上面`swapTwoInts`函數的泛型版本，用於交換兩個值： + +```swift +func swapTwoValues(inout a: T, inout b: T) { + let temporaryA = a + a = b + b = temporaryA +} +``` + +`swapTwoValues`函數主體和`swapTwoInts`函數是一樣的，它只在第一行稍微有那麼一點點不同於`swapTwoInts`，如下所示： + +```swift +func swapTwoInts(inout a: Int, inout b: Int) +func swapTwoValues(inout a: T, inout b: T) +``` + + +這個函數的泛型版本使用了佔位類型名字（通常此情況下用字母`T`來表示）來代替實際類型名（如`In`、`String`或`Doubl`）。佔位類型名沒有提示`T`必須是什麼類型，但是它提示了`a`和`b`必須是同一類型`T`，而不管`T`表示什麼類型。只有`swapTwoValues`函數在每次調用時所傳入的實際類型才能決定`T`所代表的類型。 + +另外一個不同之處在於這個泛型函數名後面跟著的展位類型名字（T）是用尖括號括起來的（``）。這個尖括號告訴 Swift 那個`T`是`swapTwoValues`函數所定義的一個類型。因為`T`是一個佔位命名類型，Swift 不會去查找命名為T的實際類型。 + +`swapTwoValues`函數除了要求傳入的兩個任何類型值是同一類型外，也可以作為`swapTwoInts`函數被調用。每次`swapTwoValues`被調用，T所代表的類型值都會傳給函數。 + +在下面的兩個例子中,`T`分別代表`Int`和`String`： + +```swift +var someInt = 3 +var anotherInt = 107 +swapTwoValues(&someInt, &anotherInt) +// someInt is now 107, and anotherInt is now 3 +``` + +```swift +var someString = "hello" +var anotherString = "world" +swapTwoValues(&someString, &anotherString) +// someString is now "world", and anotherString is now "hello" +``` + + +>注意 +上面定義的函數`swapTwoValues`是受`swap`函數啟發而實現的。`swap`函數存在於 Swift 標準庫，並可以在其它類中任意使用。如果你在自己代碼中需要類似`swapTwoValues`函數的功能，你可以使用已存在的交換函數`swap`函數。 + + +## 類型參數 + +在上面的`swapTwoValues`例子中，佔位類型`T`是一種類型參數的示例。類型參數指定並命名為一個佔位類型，並且緊隨在函數名後面，使用一對尖括號括起來（如``）。 + +一旦一個類型參數被指定，那麼其可以被使用來定義一個函數的參數類型（如`swapTwoValues`函數中的參數`a`和`b`），或作為一個函數返回類型，或用作函數主體中的註釋類型。在這種情況下，被類型參數所代表的佔位類型不管函數任何時候被調用，都會被實際類型所替換（在上面`swapTwoValues`例子中，當函數第一次被調用時，`T`被`Int`替換，第二次調用時，被`String`替換。）。 + +你可支持多個類型參數，命名在尖括號中，用逗號分開。 + + +## 命名類型參數 + +在簡單的情況下，泛型函數或泛型類型需要指定一個佔位類型（如上面的`swapTwoValues`泛型函數，或一個存儲單一類型的泛型集，如數組），通常用一單個字母`T`來命名類型參數。不過，你可以使用任何有效的標識符來作為類型參數名。 + +如果你使用多個參數定義更複雜的泛型函數或泛型類型，那麼使用更多的描述類型參數是非常有用的。例如，Swift 字典（Dictionary）類型有兩個類型參數，一個是鍵，另外一個是值。如果你自己寫字典，你或許會定義這兩個類型參數為`KeyType`和`ValueType`，用來記住它們在你的泛型代碼中的作用。 + +>注意 +請始終使用大寫字母開頭的駝峰式命名法（例如`T`和`KeyType`）來給類型參數命名，以表明它們是類型的佔位符，而非類型值。 + + +## 泛型類型 + + +通常在泛型函數中，Swift 允許你定義你自己的泛型類型。這些自定義類、結構體和枚舉作用於任何類型，如同`Array`和`Dictionary`的用法。 + +這部分向你展示如何寫一個泛型集類型--`Stack`（棧）。一個棧是一系列值域的集合，和`Array`（數組）類似，但其是一個比 Swift 的`Array`類型更多限制的集合。一個數組可以允許其裡面任何位置的插入/刪除操作，而棧，只允許在集合的末端添加新的項（如同*push*一個新值進棧）。同樣的一個棧也只能從末端移除項（如同*pop*一個值出棧）。 + +>注意 +棧的概念已被`UINavigationController`類使用來模擬試圖控制器的導航結構。你通過調用`UINavigationController`的`pushViewController:animated:`方法來為導航棧添加（add）新的試圖控制器；而通過`popViewControllerAnimated:`的方法來從導航棧中移除（pop）某個試圖控制器。每當你需要一個嚴格的`後進先出`方式來管理集合，堆棧都是最實用的模型。 + +下圖展示了一個棧的壓棧(push)/出棧(pop)的行為： + +![此處輸入圖片的描述](https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/Art/stackPushPop_2x.png) + +1. 現在有三個值在棧中； +2. 第四個值「pushed」到棧的頂部； +3. 現在有四個值在棧中，最近的那個在頂部； +4. 棧中最頂部的那個項被移除，或稱之為「popped」； +5. 移除掉一個值後，現在棧又重新只有三個值。 + +這裡展示了如何寫一個非泛型版本的棧，`Int`值型的棧： + +```swift +struct IntStack { + var items = Int[]() + mutating func push(item: Int) { + items.append(item) + } + mutating func pop() -> Int { + return items.removeLast() + } +} +``` + +這個結構體在棧中使用一個`Array`性質的`items`存儲值。`Stack`提供兩個方法：`push`和`pop`，從棧中壓進一個值和移除一個值。這些方法標記為可變的，因為它們需要修改（或*轉換*）結構體的`items`數組。 + +上面所展現的`IntStack`類型只能用於`Int`值，不過，其對於定義一個泛型`Stack`類（可以處理*任何*類型值的棧）是非常有用的。 + +這裡是一個相同代碼的泛型版本： + + +```swift +struct Stack { + var items = T[]() + mutating func push(item: T) { + items.append(item) + } + mutating func pop() -> T { + return items.removeLast() + } +} +``` + + +注意到`Stack`的泛型版本基本上和非泛型版本相同，但是泛型版本的佔位類型參數為T代替了實際`Int`類型。這種類型參數包含在一對尖括號裡（``），緊隨在結構體名字後面。 + +`T`定義了一個名為「某種類型T」的節點提供給後來用。這種將來類型可以在結構體的定義裡任何地方表示為「T」。在這種情況下，`T`在如下三個地方被用作節點： + +- 創建一個名為`items`的屬性，使用空的T類型值數組對其進行初始化； +- 指定一個包含一個參數名為`item`的`push`方法，該參數必須是T類型； +- 指定一個`pop`方法的返回值，該返回值將是一個T類型值。 + +當創建一個新單例並初始化時， 通過用一對緊隨在類型名後的尖括號裡寫出實際指定棧用到類型，創建一個`Stack`實例，同創建`Array`和`Dictionary`一樣： + +```swift +var stackOfStrings = Stack() +stackOfStrings.push("uno") +stackOfStrings.push("dos") +stackOfStrings.push("tres") +stackOfStrings.push("cuatro") +// 現在棧已經有4個string了 +``` + +下圖將展示`stackOfStrings`如何`push`這四個值進棧的過程： + +![此處輸入圖片的描述](https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/Art/stackPushedFourStrings_2x.png) + +從棧中`pop`並移除值"cuatro"： + +```swift +let fromTheTop = stackOfStrings.pop() +// fromTheTop is equal to "cuatro", and the stack now contains 3 strings +``` + +下圖展示了如何從棧中pop一個值的過程： +![此處輸入圖片的描述](https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/Art/stackPoppedOneString_2x.png) + +由於`Stack`是泛型類型，所以在 Swift 中其可以用來創建任何有效類型的棧，這種方式如同`Array`和`Dictionary`。 + + +##類型約束 + +`swapTwoValues`函數和`Stack`類型可以作用於任何類型，不過，有的時候對使用在泛型函數和泛型類型上的類型強制約束為某種特定類型是非常有用的。類型約束指定了一個必須繼承自指定類的類型參數，或者遵循一個特定的協議或協議構成。 + +例如，Swift 的`Dictionary`類型對作用於其鍵的類型做了些限制。在[字典](../chapter2/04_Collection_Types.html)的描述中，字典的鍵類型必須是*可哈希*，也就是說，必須有一種方法可以使其被唯一的表示。`Dictionary`之所以需要其鍵是可哈希是為了以便於其檢查其是否已經包含某個特定鍵的值。如無此需求，`Dictionary`既不會告訴是否插入或者替換了某個特定鍵的值，也不能查找到已經存儲在字典裡面的給定鍵值。 + +這個需求強制加上一個類型約束作用於`Dictionary`的鍵上，當然其鍵類型必須遵循`Hashable`協議（Swift 標準庫中定義的一個特定協議）。所有的 Swift 基本類型（如`String`，`Int`， `Double`和 `Bool`）默認都是可哈希。 + +當你創建自定義泛型類型時，你可以定義你自己的類型約束，當然，這些約束要支持泛型編程的強力特徵中的多數。抽像概念如`可哈希`具有的類型特徵是根據它們概念特徵來界定的，而不是它們的直接類型特徵。 + +### 類型約束語法 + +你可以寫一個在一個類型參數名後面的類型約束，通過冒號分割，來作為類型參數鏈的一部分。這種作用於泛型函數的類型約束的基礎語法如下所示（和泛型類型的語法相同）： + +```swift +func someFunction(someT: T, someU: U) { + // function body goes here +} +``` + +上面這個假定函數有兩個類型參數。第一個類型參數`T`，有一個需要`T`必須是`SomeClass`子類的類型約束；第二個類型參數`U`，有一個需要`U`必須遵循`SomeProtocol`協議的類型約束。 + +### 類型約束行為 + +這裡有個名為`findStringIndex`的非泛型函數，該函數功能是去查找包含一給定`String`值的數組。若查找到匹配的字符串，`findStringIndex`函數返回該字符串在數組中的索引值（`Int`），反之則返回`nil`： + +```swift +func findStringIndex(array: String[], valueToFind: String) -> Int? { + for (index, value) in enumerate(array) { + if value == valueToFind { + return index + } + } + return nil +} +``` + + +`findStringIndex`函數可以作用於查找一字符串數組中的某個字符串: + +```swift +let strings = ["cat", "dog", "llama", "parakeet", "terrapin"] +if let foundIndex = findStringIndex(strings, "llama") { + println("The index of llama is \(foundIndex)") +} +// 輸出 "The index of llama is 2" +``` + +如果只是針對字符串而言查找在數組中的某個值的索引，用處不是很大，不過，你可以寫出相同功能的泛型函數`findIndex`，用某個類型`T`值替換掉提到的字符串。 + +這裡展示如何寫一個你或許期望的`findStringIndex`的泛型版本`findIndex`。請注意這個函數仍然返回`Int`，是不是有點迷惑呢，而不是泛型類型?那是因為函數返回的是一個可選的索引數，而不是從數組中得到的一個可選值。需要提醒的是，這個函數不會編譯，原因在例子後面會說明： + +```swift +func findIndex(array: T[], valueToFind: T) -> Int? { + for (index, value) in enumerate(array) { + if value == valueToFind { + return index + } + } + return nil +} +``` + +上面所寫的函數不會編譯。這個問題的位置在等式的檢查上，`「if value == valueToFind」`。不是所有的 Swift 中的類型都可以用等式符（==）進行比較。例如，如果你創建一個你自己的類或結構體來表示一個複雜的數據模型，那麼 Swift 沒法猜到對於這個類或結構體而言「等於」的意思。正因如此，這部分代碼不能可能保證工作於每個可能的類型`T`，當你試圖編譯這部分代碼時估計會出現相應的錯誤。 + +不過，所有的這些並不會讓我們無從下手。Swift 標準庫中定義了一個`Equatable`協議，該協議要求任何遵循的類型實現等式符（==）和不等符（!=）對任何兩個該類型進行比較。所有的 Swift 標準類型自動支持`Equatable`協議。 + +任何`Equatable`類型都可以安全的使用在`findIndex`函數中，因為其保證支持等式操作。為了說明這個事實，當你定義一個函數時，你可以寫一個`Equatable`類型約束作為類型參數定義的一部分： + +```swift +func findIndex(array: T[], valueToFind: T) -> Int? { + for (index, value) in enumerate(array) { + if value == valueToFind { + return index + } + } + return nil +} +``` + + +`findIndex`中這個單個類型參數寫做：`T: Equatable`，也就意味著「任何T類型都遵循`Equatable`協議」。 + +`findIndex`函數現在則可以成功的編譯過，並且作用於任何遵循`Equatable`的類型，如`Double`或`String`: + +```swift +let doubleIndex = findIndex([3.14159, 0.1, 0.25], 9.3) +// doubleIndex is an optional Int with no value, because 9.3 is not in the array +let stringIndex = findIndex(["Mike", "Malcolm", "Andrea"], "Andrea") +// stringIndex is an optional Int containing a value of 2 +``` + + +##關聯類型(Associated Types) + +當定義一個協議時，有的時候聲明一個或多個關聯類型作為協議定義的一部分是非常有用的。一個關聯類型作為協議的一部分，給定了類型的一個佔位名（或別名）。作用於關聯類型上實際類型在協議被實現前是不需要指定的。關聯類型被指定為`typealias`關鍵字。 + +### 關聯類型行為 + +這裡是一個`Container`協議的例子，定義了一個ItemType關聯類型： + +```swift +protocol Container { + typealias ItemType + mutating func append(item: ItemType) + var count: Int { get } + subscript(i: Int) -> ItemType { get } +} +``` + +`Container`協議定義了三個任何容器必須支持的兼容要求： + +- 必須可能通過`append`方法添加一個新item到容器裡； +- 必須可能通過使用`count`屬性獲取容器裡items的數量，並返回一個`Int`值； +- 必須可能通過容器的`Int`索引值下標可以檢索到每一個item。 + +這個協議沒有指定容器裡item是如何存儲的或何種類型是允許的。這個協議只指定三個任何遵循`Container`類型所必須支持的功能點。一個遵循的類型在滿足這三個條件的情況下也可以提供其他額外的功能。 + +任何遵循`Container`協議的類型必須指定存儲在其裡面的值類型，必須保證只有正確類型的items可以加進容器裡，必須明確可以通過其下標返回item類型。 + +為了定義這三個條件，`Container`協議需要一個方法指定容器裡的元素將會保留，而不需要知道特定容器的類型。`Container`協議需要指定任何通過`append`方法添加到容器裡的值和容器裡元素是相同類型，並且通過容器下標返回的容器元素類型的值的類型是相同類型。 + +為了達到此目的，`Container`協議聲明了一個ItemType的關聯類型，寫作`typealias ItemType`。這個協議不會定義`ItemType`是什麼的別名，這個信息將由任何遵循協議的類型來提供。儘管如此，`ItemType`別名提供了一種識別Container中Items類型的方法，並且用於`append`方法和`subscript`方法的類型定義，以便保證任何`Container`期望的行為能夠被執行。 + +這裡是一個早前IntStack類型的非泛型版本，遵循Container協議： + +```swift +struct IntStack: Container { + // IntStack的原始實現 + var items = Int[]() + mutating func push(item: Int) { + items.append(item) + } + mutating func pop() -> Int { + return items.removeLast() + } + // 遵循Container協議的實現 + typealias ItemType = Int + mutating func append(item: Int) { + self.push(item) + } + var count: Int { + return items.count + } + subscript(i: Int) -> Int { + return items[i] + } +} +``` + + +`IntStack`類型實現了`Container`協議的所有三個要求，在`IntStack`類型的每個包含部分的功能都滿足這些要求。 + +此外，`IntStack`指定了`Container`的實現，適用的ItemType被用作`Int`類型。對於這個`Container`協議實現而言，定義 `typealias ItemType = Int`，將抽像的`ItemType`類型轉換為具體的`Int`類型。 + +感謝Swift類型參考，你不用在`IntStack`定義部分聲明一個具體的`Int`的`ItemType`。由於`IntStack`遵循`Container`協議的所有要求，只要通過簡單的查找`append`方法的item參數類型和下標返回的類型，Swift就可以推斷出合適的`ItemType`來使用。確實，如果上面的代碼中你刪除了 `typealias ItemType = Int`這一行，一切仍舊可以工作，因為它清楚的知道ItemType使用的是何種類型。 + +你也可以生成遵循`Container`協議的泛型`Stack`類型： + +```swift +struct Stack: Container { + // original Stack implementation + var items = T[]() + mutating func push(item: T) { + items.append(item) + } + mutating func pop() -> T { + return items.removeLast() + } + // conformance to the Container protocol + mutating func append(item: T) { + self.push(item) + } + var count: Int { + return items.count + } + subscript(i: Int) -> T { + return items[i] + } +} +``` + +這個時候，佔位類型參數`T`被用作`append`方法的item參數和下標的返回類型。Swift 因此可以推斷出被用作這個特定容器的`ItemType`的`T`的合適類型。 + + +### 擴展一個存在的類型為一指定關聯類型 + +在[使用擴展來添加協議兼容性](../chapter2/21_Protocols.html)中有描述擴展一個存在的類型添加遵循一個協議。這個類型包含一個關聯類型的協議。 + +Swift的`Array`已經提供`append`方法，一個`count`屬性和通過下標來查找一個自己的元素。這三個功能都達到`Container`協議的要求。也就意味著你可以擴展`Array`去遵循`Container`協議，只要通過簡單聲明`Array`適用於該協議而已。如何實踐這樣一個空擴展，在[使用擴展來聲明協議的採納](../chapter2/21_Protocols.html)中有描述這樣一個實現一個空擴展的行為： + +```swift +extension Array: Container {} +``` + +如同上面的泛型`Stack`類型一樣，`Array的append`方法和下標保證`Swift`可以推斷出`ItemType`所使用的適用的類型。定義了這個擴展後，你可以將任何`Array`當作`Container`來使用。 + + +## Where 語句 + +[類型約束](#type_constraints)能夠確保類型符合泛型函數或類的定義約束。 + +對關聯類型定義約束是非常有用的。你可以在參數列表中通過*where*語句定義參數的約束。一個`where`語句能夠使一個關聯類型遵循一個特定的協議，以及（或）那個特定的類型參數和關聯類型可以是相同的。你可以寫一個`where`語句，緊跟在在類型參數列表後面，where語句後跟一個或者多個針對關聯類型的約束，以及（或）一個或多個類型和關聯類型間的等價(equality)關係。 + +下面的例子定義了一個名為`allItemsMatch`的泛型函數，用來檢查兩個`Container`實例是否包含相同順序的相同元素。如果所有的元素能夠匹配，那麼返回一個為`true`的`Boolean`值，反之則為`false`。 + +被檢查的兩個`Container`可以不是相同類型的容器（雖然它們可以是），但它們確實擁有相同類型的元素。這個需求通過一個類型約束和`where`語句結合來表示： + +```swift +func allItemsMatch< + C1: Container, C2: Container + where C1.ItemType == C2.ItemType, C1.ItemType: Equatable> + (someContainer: C1, anotherContainer: C2) -> Bool { + + // 檢查兩個Container的元素個數是否相同 + if someContainer.count != anotherContainer.count { + return false + } + + // 檢查兩個Container相應位置的元素彼此是否相等 + for i in 0..someContainer.count { + if someContainer[i] != anotherContainer[i] { + return false + } + } + + // 如果所有元素檢查都相同則返回true + return true + +} +``` + + +這個函數用了兩個參數：`someContainer`和`anotherContainer`。`someContainer`參數是類型`C1`，`anotherContainer`參數是類型`C2`。`C1`和`C2`是容器的兩個佔位類型參數，決定了這個函數何時被調用。 + +這個函數的類型參數列緊隨在兩個類型參數需求的後面： + +- `C1`必須遵循`Container`協議 (寫作 `C1: Container`)。 +- `C2`必須遵循`Container`協議 (寫作 `C2: Container`)。 +- `C1`的`ItemType`同樣是C2的`ItemType`（寫作 `C1.ItemType == C2.ItemType`）。 +- `C1`的`ItemType`必須遵循`Equatable`協議 (寫作 `C1.ItemType: Equatable`)。 + +第三個和第四個要求被定義為一個`where`語句的一部分，寫在關鍵字`where`後面，作為函數類型參數鏈的一部分。 + +這些要求意思是： + +`someContainer`是一個`C1`類型的容器。 +`anotherContainer`是一個`C2`類型的容器。 +`someContainer`和`anotherContainer`包含相同的元素類型。 +`someContainer`中的元素可以通過不等於操作(`!=`)來檢查它們是否彼此不同。 + +第三個和第四個要求結合起來的意思是`anotherContainer`中的元素也可以通過 `!=` 操作來檢查，因為它們在`someContainer`中元素確實是相同的類型。 + +這些要求能夠使`allItemsMatch`函數比較兩個容器，即便它們是不同的容器類型。 + +`allItemsMatch`首先檢查兩個容器是否擁有同樣數目的items，如果它們的元素數目不同，沒有辦法進行匹配，函數就會`false`。 + +檢查完之後，函數通過`for-in`循環和半閉區間操作（..）來迭代`someContainer`中的所有元素。對於每個元素，函數檢查是否`someContainer`中的元素不等於對應的`anotherContainer`中的元素，如果這兩個元素不等，則這兩個容器不匹配，返回`false`。 + +如果循環體結束後未發現沒有任何的不匹配，那表明兩個容器匹配，函數返回`true`。 + +這裡演示了allItemsMatch函數運算的過程： + +```swift +var stackOfStrings = Stack() +stackOfStrings.push("uno") +stackOfStrings.push("dos") +stackOfStrings.push("tres") + +var arrayOfStrings = ["uno", "dos", "tres"] + +if allItemsMatch(stackOfStrings, arrayOfStrings) { + println("All items match.") +} else { + println("Not all items match.") +} +// 輸出 "All items match." +``` + + 上面的例子創建一個`Stack`單例來存儲`String`，然後壓了三個字符串進棧。這個例子也創建了一個`Array`單例，並初始化包含三個同棧裡一樣的原始字符串。即便棧和數組是不同的類型，但它們都遵循`Container`協議，而且它們都包含同樣的類型值。因此你可以調用`allItemsMatch`函數，用這兩個容器作為它的參數。在上面的例子中，`allItemsMatch`函數正確的顯示了所有的這兩個容器的`items`匹配。 + + [1]: ../chapter2/06_Functions.html + [2]: https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/Art/stackPushPop_2x.png + [3]: https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/Art/stackPushedFourStrings_2x.png + [4]: https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/Art/stackPoppedOneString_2x.png + [5]: ../chapter2/04_Collection_Types.html + [6]: ../chapter2/21_Protocols.html + [7]: ../chapter2/21_Protocols.html + [8]: #type_constraints diff --git a/source-tw/chapter2/23_Advanced_Operators.md b/source-tw/chapter2/23_Advanced_Operators.md new file mode 100644 index 00000000..586dc8e5 --- /dev/null +++ b/source-tw/chapter2/23_Advanced_Operators.md @@ -0,0 +1,484 @@ +> 翻譯：[xielingwang](https://github.com/xielingwang) +> 校對：[numbbbbb](https://github.com/numbbbbb) + +# 高級運算符 +----------------- + +本頁內容包括： + +- [位運算符](#bitwise_operators) +- [溢出運算符](#overflow_operators) +- [優先級和結合性(Precedence and Associativity)](#precedence_and_associativity) +- [運算符函數(Operator Functions)](#operator_functions) +- [自定義運算符](#custom_operators) + +除了[基本操作符](02_Basic_Operators.html)中所講的運算符，Swift還有許多複雜的高級運算符，包括了C語言和Objective-C中的位運算符和移位運算。 + +不同於C語言中的數值計算，Swift的數值計算默認是不可溢出的。溢出行為會被捕獲並報告為錯誤。你是故意的？好吧，你可以使用Swift為你準備的另一套默認允許溢出的數值運算符，如可溢出的加號為`&+`。所有允許溢出的運算符都是以`&`開始的。 + +自定義的結構，類和枚舉，是否可以使用標準的運算符來定義操作？當然可以！在Swift中，你可以為你創建的所有類型定制運算符的操作。 + +可定制的運算符並不限於那些預設的運算符，你可以自定義中置，前置，後置及賦值運算符，當然還有優先級和結合性。這些運算符在代碼中可以像預設的運算符一樣使用，你也可以擴展已有的類型以支持你自定義的運算符。 + + +## 位運算符 + +位操作符可以操作數據結構中原始數據的每個比特位。位操作符通常在諸如圖像處理和創建設備驅動等底層開發中使用，位操作符在同外部資源的數據進行交互的時候也很有用，比如在使用用戶協議進行通信的時候，運用位運算符來對原始數據進行編碼和解碼。 + +Swift支持如下所有C語言的位運算符： + +### 按位取反運算符 + +按位取反運算符`~`對一個操作數的每一位都取反。 + +![Art/bitwiseNOT_2x.png](https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/Art/bitwiseNOT_2x.png "Art/bitwiseNOT_2x.png") + +這個運算符是前置的，所以請不加任何空格地寫在操作數之前。 + +```swift +let initialBits: UInt8 = 0b00001111 +let invertedBits = ~initialBits // 等於 0b11110000 +``` + +`UInt8`是8位無符整型，可以存儲0~255之間的任意數。這個例子初始化一個整型為二進制值`00001111`(前4位為`0`，後4位為`1`)，它的十進制值為`15`。 + +使用按位取反運算`~`對`initialBits`操作，然後賦值給`invertedBits`這個新常量。這個新常量的值等於所有位都取反的`initialBits`，即`1`變成`0`，`0`變成`1`，變成了`11110000`，十進制值為`240`。 + +### 按位與運算符 + +按位與運算符對兩個數進行操作，然後返回一個新的數，這個數的每個位都需要兩個輸入數的同一位都為1時才為1。 + +![Art/bitwiseAND_2x.png](https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/Art/bitwiseAND_2x.png "Art/bitwiseAND_2x.png") + +以下代碼，`firstSixBits`和`lastSixBits`中間4個位都為1。對它倆進行按位與運算後，就得到了`00111100`，即十進制的`60`。 + +```swift +let firstSixBits: UInt8 = 0b11111100 +let lastSixBits: UInt8 = 0b00111111 +let middleFourBits = firstSixBits & lastSixBits // 等於 00111100 +``` + +### 按位或運算 + +按位或運算符`|`比較兩個數，然後返回一個新的數，這個數的每一位設置1的條件是兩個輸入數的同一位都不為0(即任意一個為1，或都為1)。 + +![Art/bitwiseOR_2x.png](https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/Art/bitwiseOR_2x.png "Art/bitwiseOR_2x.png") + +如下代碼，`someBits`和`moreBits`在不同位上有`1`。按位或運行的結果是`11111110`，即十進制的`254`。 + +```swift +let someBits: UInt8 = 0b10110010 +let moreBits: UInt8 = 0b01011110 +let combinedbits = someBits | moreBits // 等於 11111110 +``` + +### 按位異或運算符 + +按位異或運算符`^`比較兩個數，然後返回一個數，這個數的每個位設為`1`的條件是兩個輸入數的同一位不同，如果相同就設為`0`。 + +![Art/bitwiseXOR_2x.png](https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/Art/bitwiseXOR_2x.png "Art/bitwiseXOR_2x.png") + +以下代碼，`firstBits`和`otherBits`都有一個`1`跟另一個數不同的。所以按位異或的結果是把它這些位置為`1`，其他都置為`0`。 + +```swift +let firstBits: UInt8 = 0b00010100 +let otherBits: UInt8 = 0b00000101 +let outputBits = firstBits ^ otherBits // 等於 00010001 +``` + +### 按位左移/右移運算符 + +左移運算符`<<`和右移運算符`>>`會把一個數的所有比特位按以下定義的規則向左或向右移動指定位數。 + +按位左移和按位右移的效果相當把一個整數乘於或除於一個因子為`2`的整數。向左移動一個整型的比特位相當於把這個數乘於`2`，向右移一位就是除於`2`。 + +#### 無符整型的移位操作 + +對無符整型的移位的效果如下： + +已經存在的比特位向左或向右移動指定的位數。被移出整型存儲邊界的的位數直接拋棄，移動留下的空白位用零`0`來填充。這種方法稱為邏輯移位。 + +以下這張把展示了 `11111111 << 1`(`11111111`向左移1位)，和 `11111111 >> 1`(`11111111`向右移1位)。藍色的是被移位的，灰色是被拋棄的，橙色的`0`是被填充進來的。 + +![Art/bitshiftUnsigned_2x.png](https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/Art/bitshiftUnsigned_2x.png "Art/bitshiftUnsigned_2x.png") + +```swift +let shiftBits: UInt8 = 4 // 即二進制的00000100 +shiftBits << 1 // 00001000 +shiftBits << 2 // 00010000 +shiftBits << 5 // 10000000 +shiftBits << 6 // 00000000 +shiftBits >> 2 // 00000001 +``` + +你可以使用移位操作進行其他數據類型的編碼和解碼。 + +```swift +let pink: UInt32 = 0xCC6699 +let redComponent = (pink & 0xFF0000) >> 16 // redComponent 是 0xCC, 即 204 +let greenComponent = (pink & 0x00FF00) >> 8 // greenComponent 是 0x66, 即 102 +let blueComponent = pink & 0x0000FF // blueComponent 是 0x99, 即 153 +``` + +這個例子使用了一個`UInt32`的命名為`pink`的常量來存儲層疊樣式表`CSS`中粉色的顏色值，`CSS`顏色`#CC6699`在Swift用十六進制`0xCC6699`來表示。然後使用按位與(&)和按位右移就可以從這個顏色值中解析出紅(CC)，綠(66)，藍(99)三個部分。 + +對`0xCC6699`和`0xFF0000`進行按位與`&`操作就可以得到紅色部分。`0xFF0000`中的`0`了遮蓋了`OxCC6699`的第二和第三個字節，這樣`6699`被忽略了，只留下`0xCC0000`。 + +然後，按向右移動16位，即 `>> 16`。十六進制中每兩個字符是8比特位，所以移動16位的結果是把`0xCC0000`變成`0x0000CC`。這和`0xCC`是相等的，就是十進制的`204`。 + +同樣的，綠色部分來自於`0xCC6699`和`0x00FF00`的按位操作得到`0x006600`。然後向右移動8位，得到`0x66`，即十進制的`102`。 + +最後，藍色部分對`0xCC6699`和`0x0000FF`進行按位與運算，得到`0x000099`，無需向右移位了，所以結果就是`0x99`，即十進制的`153`。 + +#### 有符整型的移位操作 + +有符整型的移位操作相對複雜得多，因為正負號也是用二進制位表示的。(這裡舉的例子雖然都是8位的，但它的原理是通用的。) + +有符整型通過第1個比特位(稱為符號位)來表達這個整數是正數還是負數。`0`代表正數，`1`代表負數。 + +其餘的比特位(稱為數值位)存儲其實值。有符正整數和無符正整數在計算機裡的存儲結果是一樣的，下來我們來看`+4`內部的二進制結構。 + +![Art/bitshiftSignedFour_2x.png](https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/Art/bitshiftSignedFour_2x.png "Art/bitshiftSignedFour_2x.png") + +符號位為`0`，代表正數，另外7比特位二進製表示的實際值就剛好是`4`。 + +負數呢，跟正數不同。負數存儲的是2的n次方減去它的絕對值，n為數值位的位數。一個8比特的數有7個數值位，所以是2的7次方，即128。 + +我們來看`-4`存儲的二進制結構。 + +![Art/bitshiftSignedMinusFour_2x.png](https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/Art/bitshiftSignedMinusFour_2x.png "Art/bitshiftSignedMinusFour_2x.png") + +現在符號位為`1`，代表負數，7個數值位要表達的二進制值是124，即128 - 4。 + +![Art/bitshiftSignedMinusFourValue_2x.png](https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/Art/bitshiftSignedMinusFourValue_2x.png "Art/bitshiftSignedMinusFourValue_2x.png") + +負數的編碼方式稱為二進制補碼表示。這種表示方式看起來很奇怪，但它有幾個優點。 + +首先，只需要對全部8個比特位(包括符號)做標準的二進制加法就可以完成 `-1 + -4` 的操作，忽略加法過程產生的超過8個比特位表達的任何信息。 + +![Art/bitshiftSignedAddition_2x.png](https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/Art/bitshiftSignedAddition_2x.png "Art/bitshiftSignedAddition_2x.png") + +第二，由於使用二進制補碼表示，我們可以和正數一樣對負數進行按位左移右移的，同樣也是左移1位時乘於`2`，右移1位時除於`2`。要達到此目的，對有符整型的右移有一個特別的要求： + +對有符整型按位右移時，不使用0填充空白位，而是根據符號位(正數為`0`，負數為`1`)填充空白位。 + +![Art/bitshiftSigned_2x.png](https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/Art/bitshiftSigned_2x.png "Art/bitshiftSigned_2x.png") + +這就確保了在右移的過程中，有符整型的符號不會發生變化。這稱為算術移位。 + +正因為正數和負數特殊的存儲方式，向右移位使它接近於`0`。移位過程中保持符號會不變，負數在接近`0`的過程中一直是負數。 + + +## 溢出運算符 + +默認情況下，當你往一個整型常量或變量賦於一個它不能承載的大數時，Swift不會讓你這麼幹的，它會報錯。這樣，在操作過大或過小的數的時候就很安全了。 + +例如，`Int16`整型能承載的整數範圍是`-32768`到`32767`，如果給它賦上超過這個範圍的數，就會報錯： + +```swift +var potentialOverflow = Int16.max +// potentialOverflow 等於 32767, 這是 Int16 能承載的最大整數 +potentialOverflow += 1 +// 噢, 出錯了 +``` + +對過大或過小的數值進行錯誤處理讓你的數值邊界條件更靈活。 + +當然，你有意在溢出時對有效位進行截斷，你可採用溢出運算，而非錯誤處理。Swfit為整型計算提供了5個`&`符號開頭的溢出運算符。 + +- 溢出加法 `&+` +- 溢出減法 `&-` +- 溢出乘法 `&*` +- 溢出除法 `&/` +- 溢出求余 `&%` + +### 值的上溢出 + +下面例子使用了溢出加法`&+`來解剖的無符整數的上溢出 + +```swift +var willOverflow = UInt8.max +// willOverflow 等於UInt8的最大整數 255 +willOverflow = willOverflow &+ 1 +// 此時 willOverflow 等於 0 +``` + +`willOverflow`用`Int8`所能承載的最大值`255`(二進制`11111111`)，然後用`&+`加1。然後`UInt8`就無法表達這個新值的二進制了，也就導致了這個新值上溢出了，大家可以看下圖。溢出後，新值在`UInt8`的承載範圍內的那部分是`00000000`，也就是`0`。 + +![Art/overflowAddition_2x.png](https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/Art/overflowAddition_2x.png "Art/overflowAddition_2x.png") + +### 值的下溢出 + +數值也有可能因為太小而越界。舉個例子： + +`UInt8`的最小值是`0`(二進制為`00000000`)。使用`&-`進行溢出減1，就會得到二進制的`11111111`即十進制的`255`。 + +![Art/overflowUnsignedSubtraction_2x.png](https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/Art/overflowUnsignedSubtraction_2x.png "Art/overflowUnsignedSubtraction_2x.png") + +Swift代碼是這樣的: + +```swift +var willUnderflow = UInt8.min +// willUnderflow 等於UInt8的最小值0 +willUnderflow = willUnderflow &- 1 +// 此時 willUnderflow 等於 255 +``` + +有符整型也有類似的下溢出，有符整型所有的減法也都是對包括在符號位在內的二進制數進行二進制減法的，這在 "按位左移/右移運算符" 一節提到過。最小的有符整數是`-128`，即二進制的`10000000`。用溢出減法減去去1後，變成了`01111111`，即UInt8所能承載的最大整數`127`。 + +![Art/overflowSignedSubtraction_2x.png](https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/Art/overflowSignedSubtraction_2x.png "Art/overflowSignedSubtraction_2x.png") + +來看看Swift代碼： + +```swift +var signedUnderflow = Int8.min +// signedUnderflow 等於最小的有符整數 -128 +signedUnderflow = signedUnderflow &- 1 +// 此時 signedUnderflow 等於 127 +``` + +### 除零溢出 + +一個數除於0 `i / 0`，或者對0求餘數 `i % 0`，就會產生一個錯誤。 + +```swift +let x = 1 +let y = x / 0 +``` + +使用它們對應的可溢出的版本的運算符`&/`和`&%`進行除0操作時就會得到`0`值。 + +```swift +let x = 1 +let y = x &/ 0 +// y 等於 0 +``` + + +## 優先級和結合性 + +運算符的優先級使得一些運算符優先於其他運算符，高優先級的運算符會先被計算。 + +結合性定義相同優先級的運算符在一起時是怎麼組合或關聯的，是和左邊的一組呢，還是和右邊的一組。意思就是，到底是和左邊的表達式結合呢，還是和右邊的表達式結合？ + +在混合表達式中，運算符的優先級和結合性是非常重要的。舉個例子，為什麼下列表達式的結果為`4`？ + +```swift +2 + 3 * 4 % 5 +// 結果是 4 +``` + +如果嚴格地從左計算到右，計算過程會是這樣： + + +- 2 + 3 = 5 +- 5 * 4 = 20 +- 20 / 5 = 4 余 0 + +但是正確答案是`4`而不是`0`。優先級高的運算符要先計算，在Swift和C語言中，都是先乘除後加減的。所以，執行完乘法和求余運算才能執行加減運算。 + +乘法和求余擁有相同的優先級，在運算過程中，我們還需要結合性，乘法和求余運算都是左結合的。這相當於在表達式中有隱藏的括號讓運算從左開始。 + +```swift +2 + ((3 * 4) % 5) +``` + +3 * 4 = 12，所以這相當於： + + +```swift +2 + (12 % 5) +``` + +12 % 5 = 2，所這又相當於 + +```swift +2 + 2 +``` + +計算結果為 4。 + +查閱Swift運算符的優先級和結合性的完整列表，請看[表達式](../chapter3/04_Expressions.html)。 + +> 注意： +Swift的運算符較C語言和Objective-C來得更簡單和保守，這意味著跟基於C的語言可能不一樣。所以，在移植已有代碼到Swift時，注意去確保代碼按你想的那樣去執行。 + + +## 運算符函數 + +讓已有的運算符也可以對自定義的類和結構進行運算，這稱為運算符重載。 + +這個例子展示了如何用`+`讓一個自定義的結構做加法。算術運算符`+`是一個兩目運算符，因為它有兩個操作數，而且它必須出現在兩個操作數之間。 + +例子中定義了一個名為`Vector2D`的二維坐標向量 `(x，y)` 的結構，然後定義了讓兩個`Vector2D`的對象相加的運算符函數。 + +```swift +struct Vector2D { + var x = 0.0, y = 0.0 +} +@infix func + (left: Vector2D, right: Vector2D) -> Vector2D { + return Vector2D(x: left.x + right.x, y: left.y + right.y) +} +``` + +該運算符函數定義了一個全局的`+`函數，這個函數需要兩個`Vector2D`類型的參數，返回值也是`Vector2D`類型。需要定義和實現一個中置運算的時候，在關鍵字`func`之前寫上屬性 `@infix` 就可以了。 + +在這個代碼實現中，參數被命名為了`left`和`right`，代表`+`左邊和右邊的兩個`Vector2D`對象。函數返回了一個新的`Vector2D`的對象，這個對象的`x`和`y`分別等於兩個參數對象的`x`和`y`的和。 + +這個函數是全局的，而不是`Vector2D`結構的成員方法，所以任意兩個`Vector2D`對象都可以使用這個中置運算符。 + +```swift +let vector = Vector2D(x: 3.0, y: 1.0) +let anotherVector = Vector2D(x: 2.0, y: 4.0) +let combinedVector = vector + anotherVector +// combinedVector 是一個新的Vector2D, 值為 (5.0, 5.0) +``` + +這個例子實現兩個向量 `(3.0，1.0)` 和 `(2.0，4.0)` 相加，得到向量 `(5.0，5.0)` 的過程。如下圖示： + +![Art/vectorAddition_2x.png](https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/Art/vectorAddition_2x.png "Art/vectorAddition_2x.png") + +### 前置和後置運算符 + +上個例子演示了一個雙目中置運算符的自定義實現，同樣我們也可以玩標準單目運算符的實現。單目運算符只有一個操作數，在操作數之前就是前置的，如`-a`; 在操作數之後就是後置的，如`i++`。 + +實現一個前置或後置運算符時，在定義該運算符的時候於關鍵字`func`之前標注 `@prefix` 或 `@postfix` 屬性。 + +```swift +@prefix func - (vector: Vector2D) -> Vector2D { + return Vector2D(x: -vector.x, y: -vector.y) +} +``` + +這段代碼為`Vector2D`類型提供了單目減運算`-a`，`@prefix`屬性表明這是個前置運算符。 + +對於數值，單目減運算符可以把正數變負數，把負數變正數。對於`Vector2D`，單目減運算將其`x`和`y`都進進行單目減運算。 + +```swift +let positive = Vector2D(x: 3.0, y: 4.0) +let negative = -positive +// negative 為 (-3.0, -4.0) +let alsoPositive = -negative +// alsoPositive 為 (3.0, 4.0) +``` + +### 組合賦值運算符 + +組合賦值是其他運算符和賦值運算符一起執行的運算。如`+=`把加運算和賦值運算組合成一個操作。實現一個組合賦值符號需要使用`@assignment`屬性，還需要把運算符的左參數設置成`inout`，因為這個參數會在運算符函數內直接修改它的值。 + +```swift +@assignment func += (inout left: Vector2D, right: Vector2D) { + left = left + right +} +``` + +因為加法運算在之前定義過了，這裡無需重新定義。所以，加賦運算符函數使用已經存在的高級加法運算符函數來執行左值加右值的運算。 + +```swift +var original = Vector2D(x: 1.0, y: 2.0) +let vectorToAdd = Vector2D(x: 3.0, y: 4.0) +original += vectorToAdd +// original 現在為 (4.0, 6.0) +``` + +你可以將 `@assignment` 屬性和 `@prefix` 或 `@postfix` 屬性起來組合，實現一個`Vector2D`的前置運算符。 + +```swift +@prefix @assignment func ++ (inout vector: Vector2D) -> Vector2D { + vector += Vector2D(x: 1.0, y: 1.0) + return vector +} +``` + +這個前置使用了已經定義好的高級加賦運算，將自己加上一個值為 `(1.0，1.0)` 的對象然後賦給自己，然後再將自己返回。 + +```swift +var toIncrement = Vector2D(x: 3.0, y: 4.0) +let afterIncrement = ++toIncrement +// toIncrement 現在是 (4.0, 5.0) +// afterIncrement 現在也是 (4.0, 5.0) +``` + +>注意： +默認的賦值符(=)是不可重載的。只有組合賦值符可以重載。三目條件運算符 `a？b：c` 也是不可重載。 + +### 比較運算符 + +Swift無所知道自定義類型是否相等或不等，因為等於或者不等於由你的代碼說了算了。所以自定義的類和結構要使用比較符`==`或`!=`就需要重載。 + +定義相等運算符函數跟定義其他中置運算符雷同： + +```swift +@infix func == (left: Vector2D, right: Vector2D) -> Bool { + return (left.x == right.x) && (left.y == right.y) +} + +@infix func != (left: Vector2D, right: Vector2D) -> Bool { + return !(left == right) +} +``` + +上述代碼實現了相等運算符`==`來判斷兩個`Vector2D`對象是否有相等的值，相等的概念就是它們有相同的`x`值和相同的`y`值，我們就用這個邏輯來實現。接著使用`==`的結果實現了不相等運算符`!=`。 + +現在我們可以使用這兩個運算符來判斷兩個`Vector2D`對象是否相等。 + +```swift +let twoThree = Vector2D(x: 2.0, y: 3.0) +let anotherTwoThree = Vector2D(x: 2.0, y: 3.0) +if twoThree == anotherTwoThree { + println("這兩個向量是相等的.") +} +// prints "這兩個向量是相等的." +``` + +### 自定義運算符 + +標準的運算符不夠玩，那你可以聲明一些個性的運算符，但個性的運算符只能使用這些字符 `/ = - + * % < >！& | ^。~`。 + +新的運算符聲明需在全局域使用`operator`關鍵字聲明，可以聲明為前置，中置或後置的。 + +```swift +operator prefix +++ {} +``` + + +這段代碼定義了一個新的前置運算符叫`+++`，此前Swift並不存在這個運算符。此處為了演示，我們讓`+++`對`Vector2D`對象的操作定義為 `雙自增` 這樣一個獨有的操作，這個操作使用了之前定義的加賦運算實現了自已加上自己然後返回的運算。 + +```swift +@prefix @assignment func +++ (inout vector: Vector2D) -> Vector2D { + vector += vector + return vector +} +``` + +`Vector2D` 的 `+++` 的實現和 `++` 的實現很接近, 唯一不同的是前者是加自己, 後者是加值為 `(1.0, 1.0)` 的向量. + +```swift +var toBeDoubled = Vector2D(x: 1.0, y: 4.0) +let afterDoubling = +++toBeDoubled +// toBeDoubled 現在是 (2.0, 8.0) +// afterDoubling 現在也是 (2.0, 8.0) +``` + +### 自定義中置運算符的優先級和結合性 + +可以為自定義的中置運算符指定優先級和結合性。可以回頭看看[優先級和結合性](#PrecedenceandAssociativity)解釋這兩個因素是如何影響多種中置運算符混合的表達式的計算的。 + +結合性(associativity)的值可取的值有`left`，`right`和`none`。左結合運算符跟其他優先級相同的左結合運算符寫在一起時，會跟左邊的操作數結合。同理，右結合運算符會跟右邊的操作數結合。而非結合運算符不能跟其他相同優先級的運算符寫在一起。 + +結合性(associativity)的值默認為`none`，優先級(precedence)默認為`100`。 + +以下例子定義了一個新的中置符`+-`，是左結合的`left`，優先級為`140`。 + +```swift +operator infix +- { associativity left precedence 140 } +func +- (left: Vector2D, right: Vector2D) -> Vector2D { + return Vector2D(x: left.x + right.x, y: left.y - right.y) +} +let firstVector = Vector2D(x: 1.0, y: 2.0) +let secondVector = Vector2D(x: 3.0, y: 4.0) +let plusMinusVector = firstVector +- secondVector +// plusMinusVector 此時的值為 (4.0, -2.0) +``` + +這個運算符把兩個向量的`x`相加，把向量的`y`相減。因為他實際是屬於加減運算，所以讓它保持了和加法一樣的結合性和優先級(`left`和`140`)。查閱完整的Swift默認結合性和優先級的設置，請移步[表達式](../chapter3/04_Expressions.html); diff --git a/source-tw/chapter2/chapter2.md b/source-tw/chapter2/chapter2.md new file mode 100644 index 00000000..ae5e206c --- /dev/null +++ b/source-tw/chapter2/chapter2.md @@ -0,0 +1,3 @@ +# Swift 教程 + +本章介紹了 Swift 的各種特性及其使用方法，是全書的核心部分。 diff --git a/source-tw/chapter3/01_About_the_Language_Reference.md b/source-tw/chapter3/01_About_the_Language_Reference.md new file mode 100644 index 00000000..abd207c7 --- /dev/null +++ b/source-tw/chapter3/01_About_the_Language_Reference.md @@ -0,0 +1,38 @@ +> 翻譯：[dabing1022](https://github.com/dabing1022) +> 校對：[numbbbbb](https://github.com/numbbbbb) + + +# 關於語言附註 +----------------- + +本頁內容包括： + +- [如何閱讀語法](#how_to_read_the_grammar) + +本書的這一節描述了Swift編程語言的形式語法。這裡描述的語法是為了幫助您更詳細的瞭解該語言，而不是讓您直接實現一個解析器或編譯器。 + + +Swift語言相對小點，這是由於在Swift代碼中幾乎無處不在的許多常見的的類型，函數以及運算符都由Swift標準庫來定義。雖然這些類型，函數和運算符不是Swift語言本身的一部分，但是它們被廣泛用於這本書的討論和代碼範例。 + + +## 如何閱讀語法 + +用來描述Swift編程語言形式語法的記法遵循下面幾個約定： + +-](https://github.com/numbbbbb)箭頭（→）用來標記語法產式，可以被理](https://github.com/numbbbbb)解為「可以包含」。 +- 句法範疇由*斜體*文字表示，並出現在一個語法產式規則兩側。 +- 義詞和標點符號由粗體固定寬度的文本顯示和只出現在一個語法產式規則的右邊。 +- 選擇性的語法產式由豎線（|）分隔。當可選用的語法產式太多時，為了閱讀方便，它們將被拆分為多行語法產式規則。 +- 在少數情況下，常規字體文字用來描述語法產式規則的右邊。 +- 可選的句法範疇和文字用尾標`opt`來標記。 + +舉個例子，getter-setter的語法塊的定義如下： + +> GRAMMAR OF A GETTER-SETTER BLOCK +> *getter-setter-block* → {- [*getter-clause*](https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/Declarations.html#//apple_ref/swift/grammar/getter-clause) [-*setter-clause*-](https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/Declarations.html#//apple_ref/swift/grammar/setter-clause)*opt* -}- | {- [*setter-clause*](https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/Declarations.html#//apple_ref/swift/grammar/setter-clause) [-*getter-clause*](https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/Declarations.html#//apple_ref/swift/grammar/getter-clause)-}- + +這個定義表明，一個getter-setter方法□□塊可以由一個getter子句後跟一個可選的setter子句構成，用大括號括起來，或者由一個setter子句後跟一個getter子句構成，用大括號括起來。上述的文法產生等價於下面的兩個產生，明確闡明如何二中擇一： + +> GRAMMAR OF A GETTER-SETTER BLOCK +> getter-setter-block → {- [*getter-clause*](https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/Declarations.html#//apple_ref/swift/grammar/getter-clause) [*-setter-clause*-](https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/Declarations.html#//apple_ref/swift/grammar/setter-clause)*opt* -}-- +> getter-setter-block → {- [*setter-clause*](https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/Declarations.html#//apple_ref/swift/grammar/setter-clause) [*-getter-clause*](https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/Declarations.html#//apple_ref/swift/grammar/getter-clause)-}- diff --git a/source-tw/chapter3/02_Lexical_Structure.md b/source-tw/chapter3/02_Lexical_Structure.md new file mode 100644 index 00000000..1deb94ef --- /dev/null +++ b/source-tw/chapter3/02_Lexical_Structure.md @@ -0,0 +1,238 @@ +> 翻譯：[superkam](https://github.com/superkam) +> 校對：[numbbbbb](https://github.com/numbbbbb) + +# 詞法結構 +----------------- + +本頁包含內容： + +- [空白與註釋（*Whitespace and Comments*）](#whitespace_and_comments) +- [標識符（*Identifiers*）](#identifiers) +- [關鍵字（*Keywords*）](#keywords) +- [字面量（*Literals*）](#literals) +- [運算符（*Operators*）](#operators) + +Swift 的「詞法結構（*lexical structure*）」描述了如何在該語言中用字符序列構建合法標記，組成該語言中最底層的代碼塊，並在之後的章節中用於描述語言的其他部分。 + +通常，標記在隨後介紹的語法約束下，由 Swift 源文件的輸入文本中提取可能的最長子串生成。這種方法稱為「最長匹配項（*longest match*）」，或者「最大適合」（*maximal munch*）。 + + +## 空白與註釋 + +空白（*whitespace*）有兩個用途：分隔源文件中的標記和區分運算符屬於前綴還是後綴，（參見 [運算符](https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/LexicalStructure.html#//apple_ref/doc/uid/TP40014097-CH30-XID_871)）在其他情況下則會被忽略。以下的字符會被當作空白：空格（*space*）（U+0020）、換行符（*line feed*）（U+000A）、回車符（*carriage return*）（U+000D）、水平 tab（*horizontal tab*）（U+0009）、垂直 tab（*vertical tab*）（U+000B）、換頁符（*form feed*）（U+000C）以及空（*null*）（U+0000）。 + +註釋（*comments*）被編譯器當作空白處理。單行註釋由 `//` 開始直到該行結束。多行註釋由 `/*` 開始，以 `*/` 結束。可以嵌套註釋，但注意註釋標記必須匹配。 + + +## 標識符 + +標識符（*identifiers*）可以由以下的字符開始：大寫或小寫的字母 `A` 到 `Z`、下劃線 `_`、基本多語言面（*Basic Multilingual Plane*）中的 Unicode 非組合字符以及基本多語言面以外的非專用區（*Private Use Area*）字符。首字符之後，標識符允許使用數字和 Unicode 字符組合。 + +使用保留字（*reserved word*）作為標識符，需要在其前後增加反引號 \`。例如，class 不是合法的標識符，但可以使用 \`class\`。反引號不屬於標識符的一部分，\`x\` 和 `x` 表示同一標識符。 + +閉包（*closure*）中如果沒有明確指定參數名稱，參數將被隱式命名為 $0、$1、$2... 這些命名在閉包作用域內是合法的標識符。 + +> 標識符語法 +> *標識符* → [*標識符頭(Head)*](LexicalStructure.html#identifier_head) [*標識符字符列表*](LexicalStructure.html#identifier_characters) _可選_ +> *標識符* → **`** [*標識符頭(Head)*](LexicalStructure.html#identifier_head) [*標識符字符列表*](LexicalStructure.html#identifier_characters) _可選_ **`** +> *標識符* → [*隱式參數名*](LexicalStructure.html#implicit_parameter_name) +> *標識符列表* → [*標識符*](LexicalStructure.html#identifier) | [*標識符*](LexicalStructure.html#identifier) **,** [*標識符列表*](LexicalStructure.html#identifier_list) +> *標識符頭(Head)* → Upper- or lowercase letter A through Z +> *標識符頭(Head)* → U+00A8, U+00AA, U+00AD, U+00AF, U+00B2–U+00B5, or U+00B7–U+00BA +> *標識符頭(Head)* → U+00BC–U+00BE, U+00C0–U+00D6, U+00D8–U+00F6, or U+00F8–U+00FF +> *標識符頭(Head)* → U+0100–U+02FF, U+0370–U+167F, U+1681–U+180D, or U+180F–U+1DBF +> *標識符頭(Head)* → U+1E00–U+1FFF +> *標識符頭(Head)* → U+200B–U+200D, U+202A–U+202E, U+203F–U+2040, U+2054, or U+2060–U+206F +> *標識符頭(Head)* → U+2070–U+20CF, U+2100–U+218F, U+2460–U+24FF, or U+2776–U+2793 +> *標識符頭(Head)* → U+2C00–U+2DFF or U+2E80–U+2FFF +> *標識符頭(Head)* → U+3004–U+3007, U+3021–U+302F, U+3031–U+303F, or U+3040–U+D7FF +> *標識符頭(Head)* → U+F900–U+FD3D, U+FD40–U+FDCF, U+FDF0–U+FE1F, or U+FE30–U+FE44 +> *標識符頭(Head)* → U+FE47–U+FFFD +> *標識符頭(Head)* → U+10000–U+1FFFD, U+20000–U+2FFFD, U+30000–U+3FFFD, or U+40000–U+4FFFD +> *標識符頭(Head)* → U+50000–U+5FFFD, U+60000–U+6FFFD, U+70000–U+7FFFD, or U+80000–U+8FFFD +> *標識符頭(Head)* → U+90000–U+9FFFD, U+A0000–U+AFFFD, U+B0000–U+BFFFD, or U+C0000–U+CFFFD +> *標識符頭(Head)* → U+D0000–U+DFFFD or U+E0000–U+EFFFD +> *標識符字符* → 數值 0 到 9 +> *標識符字符* → U+0300–U+036F, U+1DC0–U+1DFF, U+20D0–U+20FF, or U+FE20–U+FE2F +> *標識符字符* → [*標識符頭(Head)*](LexicalStructure.html#identifier_head) +> *標識符字符列表* → [*標識符字符*](LexicalStructure.html#identifier_character) [*標識符字符列表*](LexicalStructure.html#identifier_characters) _可選_ +> *隱式參數名* → **$** [*十進制數字列表*](LexicalStructure.html#decimal_digits) + + +## 關鍵字 + +被保留的關鍵字（*keywords*）不允許用作標識符，除非被反引號轉義，參見 [標識符](https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/LexicalStructure.html#//apple_ref/doc/uid/TP40014097-CH30-XID_796)。 + +* **用作聲明的關鍵字：** *class*、*deinit*、*enum*、*extension*、*func*、*import*、*init*、*let*、*protocol*、*static*、*struct*、*subscript*、*typealias*、*var* +* **用作語句的關鍵字：** *break*、*case*、*continue*、*default*、*do*、*else*、*fallthrough*、*if*、*in*、*for*、*return*、*switch*、*where*、*while* +* **用作表達和類型的關鍵字：** *as*、*dynamicType*、*is*、*new*、*super*、*self*、*Self*、*Type*、*\_\_COLUMN\_\_*、*\_\_FILE\_\_*、*\_\_FUNCTION\_\_*、*\_\_LINE\_\_* +* **特定上下文中被保留的關鍵字：** *associativity*、*didSet*、*get*、*infix*、*inout*、*left*、*mutating*、*none*、*nonmutating*、*operator*、*override*、*postfix*、 + *precedence*、*prefix*、*right*、*set*、*unowned*、*unowned(safe)*、*unowned(unsafe)*、*weak*、*willSet*，這些關鍵字在特定上下文之外可以被用於標識符。 + + +## 字面量 + +字面值表示整型、浮點型數字或文本類型的值，舉例如下： + +```swift +42 // 整型字面量 +3.14159 // 浮點型字面量 +"Hello, world!" // 文本型字面量 +``` + +> 字面量語法 +> *字面量* → [*整型字面量*](LexicalStructure.html#integer_literal) | [*浮點數字面量*](LexicalStructure.html#floating_point_literal) | [*字符串字面量*](LexicalStructure.html#string_literal) + +### 整型字面量 + +整型字面量（*integer literals*）表示未指定精度整型數的值。整型字面量默認用十進製表示，可以加前綴來指定其他的進制，二進制字面量加 `0b`，八進制字面量加 `0o`，十六進制字面量加 `0x`。 + +十進制字面量包含數字 `0` 至 `9`。二進制字面量只包含 `0` 或 `1`，八進制字面量包含數字 `0` 至 `7`，十六進制字面量包含數字 `0` 至 `9` 以及字母 `A` 至 `F` （大小寫均可）。 + +負整數的字面量在數字前加減號 `-`，比如 `-42`。 + +允許使用下劃線 `_` 來增加數字的可讀性，下劃線不會影響字面量的值。整型字面量也可以在數字前加 `0`，同樣不會影響字面量的值。 + +```swift +1000_000 // 等於 1000000 +005 // 等於 5 +``` + +除非特殊指定，整型字面量的默認類型為 Swift 標準庫類型中的 `Int`。Swift 標準庫還定義了其他不同長度以及是否帶符號的整數類型，請參考 [整數類型](https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/TheBasics.html#//apple_ref/doc/uid/TP40014097-CH5-XID_411)。 + +> 整型字面量語法 +> *整型字面量* → [*二進制字面量*](LexicalStructure.html#binary_literal) +> *整型字面量* → [*八進制字面量*](LexicalStructure.html#octal_literal) +> *整型字面量* → [*十進制字面量*](LexicalStructure.html#decimal_literal) +> *整型字面量* → [*十六進制字面量*](LexicalStructure.html#hexadecimal_literal) +> *二進制字面量* → **0b** [*二進制數字*](LexicalStructure.html#binary_digit) [*二進制字面量字符列表*](LexicalStructure.html#binary_literal_characters) _可選_ +> *二進制數字* → 數值 0 到 1 +> *二進制字面量字符* → [*二進制數字*](LexicalStructure.html#binary_digit) | **_** +> *二進制字面量字符列表* → [*二進制字面量字符*](LexicalStructure.html#binary_literal_character) [*二進制字面量字符列表*](LexicalStructure.html#binary_literal_characters) _可選_ +> *八進制字面量* → **0o** [*八進字數字*](LexicalStructure.html#octal_digit) [*八進制字符列表*](LexicalStructure.html#octal_literal_characters) _可選_ +> *八進字數字* → 數值 0 到 7 +> *八進制字符* → [*八進字數字*](LexicalStructure.html#octal_digit) | **_** +> *八進制字符列表* → [*八進制字符*](LexicalStructure.html#octal_literal_character) [*八進制字符列表*](LexicalStructure.html#octal_literal_characters) _可選_ +> *十進制字面量* → [*十進制數字*](LexicalStructure.html#decimal_digit) [*十進制字符列表*](LexicalStructure.html#decimal_literal_characters) _可選_ +> *十進制數字* → 數值 0 到 9 +> *十進制數字列表* → [*十進制數字*](LexicalStructure.html#decimal_digit) [*十進制數字列表*](LexicalStructure.html#decimal_digits) _可選_ +> *十進制字符* → [*十進制數字*](LexicalStructure.html#decimal_digit) | **_** +> *十進制字符列表* → [*十進制字符*](LexicalStructure.html#decimal_literal_character) [*十進制字符列表*](LexicalStructure.html#decimal_literal_characters) _可選_ +> *十六進制字面量* → **0x** [*十六進制數字*](LexicalStructure.html#hexadecimal_digit) [*十六進制字面量字符列表*](LexicalStructure.html#hexadecimal_literal_characters) _可選_ +> *十六進制數字* → 數值 0 到 9, a through f, or A through F +> *十六進制字符* → [*十六進制數字*](LexicalStructure.html#hexadecimal_digit) | **_** +> *十六進制字面量字符列表* → [*十六進制字符*](LexicalStructure.html#hexadecimal_literal_character) [*十六進制字面量字符列表*](LexicalStructure.html#hexadecimal_literal_characters) _可選_ + +### 浮點型字面量 + +浮點型字面量（*floating-point literals*）表示未指定精度浮點數的值。 + +浮點型字面量默認用十進製表示（無前綴），也可以用十六進製表示（加前綴 `0x`）。 + +十進制浮點型字面量（*decimal floating-point literals*）由十進制數字串後跟小數部分或指數部分（或兩者皆有）組成。十進制小數部分由小數點 `.` 後跟十進制數字串組成。指數部分由大寫或小寫字母 `e` 後跟十進制數字串組成，這串數字表示 `e` 之前的數量乘以 10 的幾次方。例如：`1.25e2` 表示 `1.25 □ 10^2`，也就是 `125.0`；同樣，`1.25e－2` 表示 `1.25 □ 10^－2`，也就是 `0.0125`。 + +十六進制浮點型字面量（*hexadecimal floating-point literals*）由前綴 `0x` 後跟可選的十六進制小數部分以及十六進制指數部分組成。十六進制小數部分由小數點後跟十六進制數字串組成。指數部分由大寫或小寫字母 `p` 後跟十進制數字串組成，這串數字表示 `p` 之前的數量乘以 2 的幾次方。例如：`0xFp2` 表示 `15 □ 2^2`，也就是 `60`；同樣，`0xFp-2` 表示 `15 □ 2^-2`，也就是 `3.75`。 + +與整型字面量不同，負的浮點型字面量由一元運算符減號 `-` 和浮點型字面量組成，例如 `-42.0`。這代表一個表達式，而不是一個浮點整型字面量。 + +允許使用下劃線 `_` 來增強可讀性，下劃線不會影響字面量的值。浮點型字面量也可以在數字前加 `0`，同樣不會影響字面量的值。 + +```swift +10_000.56 // 等於 10000.56 +005000.76 // 等於 5000.76 +``` + +除非特殊指定，浮點型字面量的默認類型為 Swift 標準庫類型中的 `Double`，表示64位浮點數。Swift 標準庫也定義 `Float` 類型，表示32位浮點數。 + +> 浮點型字面量語法 +> *浮點數字面量* → [*十進制字面量*](LexicalStructure.html#decimal_literal) [*十進制分數*](LexicalStructure.html#decimal_fraction) _可選_ [*十進制指數*](LexicalStructure.html#decimal_exponent) _可選_ +> *浮點數字面量* → [*十六進制字面量*](LexicalStructure.html#hexadecimal_literal) [*十六進制分數*](LexicalStructure.html#hexadecimal_fraction) _可選_ [*十六進制指數*](LexicalStructure.html#hexadecimal_exponent) +> *十進制分數* → **.** [*十進制字面量*](LexicalStructure.html#decimal_literal) +> *十進制指數* → [*浮點數e*](LexicalStructure.html#floating_point_e) [*正負號*](LexicalStructure.html#sign) _可選_ [*十進制字面量*](LexicalStructure.html#decimal_literal) +> *十六進制分數* → **.** [*十六進制字面量*](LexicalStructure.html#hexadecimal_literal) _可選_ +> *十六進制指數* → [*浮點數p*](LexicalStructure.html#floating_point_p) [*正負號*](LexicalStructure.html#sign) _可選_ [*十六進制字面量*](LexicalStructure.html#hexadecimal_literal) +> *浮點數e* → **e** | **E** +> *浮點數p* → **p** | **P** +> *正負號* → **+** | **-** + +### 文本型字面量 + +文本型字面量（*string literal*）由雙引號中的字符串組成，形式如下： + +```swift +"characters" +``` + +文本型字面量中不能包含未轉義的雙引號 `"`、未轉義的反斜線`\`、回車符（*carriage return*）或換行符（*line feed*）。 + +可以在文本型字面量中使用的轉義特殊符號如下： + +* 空字符（Null Character）`\0` +* 反斜線（Backslash）`\\` +* 水平 Tab （Horizontal Tab）`\t` +* 換行符（Line Feed）`\n` +* 回車符（Carriage Return）`\r` +* 雙引號（Double Quote）`\"` +* 單引號（Single Quote）`\'` + +字符也可以用以下方式表示： + +* `\x` 後跟兩位十六進制數字 +* `\u` 後跟四位十六進制數字 +* `\U` 後跟八位十六進制數字 + +後跟的數字表示一個 Unicode 碼點。 + +文本型字面量允許在反斜線小括號 `\()` 中插入表達式的值。插入表達式（*interpolated expression*）不能包含未轉義的雙引號 `"`、反斜線 `\`、回車符或者換行符。表達式值的類型必須在 *String* 類中有對應的初始化方法。 + +例如，以下所有文本型字面量的值相同： + +```swift +"1 2 3" +"1 2 \(3)" +"1 2 \(1 + 2)" +var x = 3; "1 2 \(x)" +``` + +文本型字面量的默認類型為 `String`。組成字符串的字符類型為 `Character`。更多有關 `String` 和 `Character` 的信息請參照 [字符串和字符](https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/StringsAndCharacters.html#//apple_ref/doc/uid/TP40014097-CH7-XID_368)。 + +> 字符型字面量語法 +> *字符串字面量* → **"** [*引用文本*](LexicalStructure.html#quoted_text) **"** +> *引用文本* → [*引用文本條目*](LexicalStructure.html#quoted_text_item) [*引用文本*](LexicalStructure.html#quoted_text) _可選_ +> *引用文本條目* → [*轉義字符*](LexicalStructure.html#escaped_character) +> *引用文本條目* → **\(** [*表達式*](..\chapter3\04_Expressions.html#expression) **)** +> *引用文本條目* → 除了"-, \-, U+000A, or U+000D的所有Unicode的字符 +> *轉義字符* → **\0** | **\\** | **\t** | **\n** | **\r** | **\"** | **\'** +> *轉義字符* → **\x** [*十六進制數字*](LexicalStructure.html#hexadecimal_digit) [*十六進制數字*](LexicalStructure.html#hexadecimal_digit) +> *轉義字符* → **\u** [*十六進制數字*](LexicalStructure.html#hexadecimal_digit) [*十六進制數字*](LexicalStructure.html#hexadecimal_digit) [*十六進制數字*](LexicalStructure.html#hexadecimal_digit) [*十六進制數字*](LexicalStructure.html#hexadecimal_digit) +> *轉義字符* → **\U** [*十六進制數字*](LexicalStructure.html#hexadecimal_digit) [*十六進制數字*](LexicalStructure.html#hexadecimal_digit) [*十六進制數字*](LexicalStructure.html#hexadecimal_digit) [*十六進制數字*](LexicalStructure.html#hexadecimal_digit) [*十六進制數字*](LexicalStructure.html#hexadecimal_digit) [*十六進制數字*](LexicalStructure.html#hexadecimal_digit) [*十六進制數字*](LexicalStructure.html#hexadecimal_digit) [*十六進制數字*](LexicalStructure.html#hexadecimal_digit) + + +## 運算符 + +Swift 標準庫定義了許多可供使用的運算符，其中大部分在 [基礎運算符](https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/BasicOperators.html#//apple_ref/doc/uid/TP40014097-CH6-XID_70) 和 [高級運算符](https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/AdvancedOperators.html#//apple_ref/doc/uid/TP40014097-CH27-XID_28) 中進行了闡述。這裡將描述哪些字符能用作運算符。 + +運算符由一個或多個以下字符組成： +`/`、`=`、`-`、`+`、`!`、`*`、`%`、`<`、`>`、`&`、`|`、`^`、`~`、`.`。也就是說，標記 `=`, `->`、`//`、`/*`、`*/`、`.` 以及一元前綴運算符 `&` 屬於保留字，這些標記不能被重寫或用於自定義運算符。 + +運算符兩側的空白被用來區分該運算符是否為前綴運算符（*prefix operator*）、後綴運算符（*postfix operator*）或二元運算符（*binary operator*）。規則總結如下： + +* 如果運算符兩側都有空白或兩側都無空白，將被看作二元運算符。例如：`a+b` 和 `a + b` 中的運算符 `+` 被看作二元運算符。 +* 如果運算符只有左側空白，將被看作前綴一元運算符。例如 `a ++b` 中的 `++` 被看作前綴一元運算符。 +* 如果運算符只有右側空白，將被看作後綴一元運算符。例如 `a++ b` 中的 `++` 被看作後綴一元運算符。 +* 如果運算符左側沒有空白並緊跟 `.`，將被看作後綴一元運算符。例如 `a++.b` 中的 `++` 被看作後綴一元運算符（同理， `a++ . b` 中的 `++` 是後綴一元運算符而 `a ++ .b` 中的 `++` 不是）. + +鑒於這些規則，運算符前的字符 `(`、`[` 和 `{` ；運算符後的字符 `)`、`]` 和 `}` 以及字符 `,`、`;` 和 `:` 都將用於空白檢測。 + +以上規則需注意一點，如果運算符 `!` 或 `?` 左側沒有空白，則不管右側是否有空白都將被看作後綴運算符。如果將 `?` 用作可選類型（*optional type*）修飾，左側必須無空白。如果用於條件運算符 `? :`，必須兩側都有空白。 + +在特定構成中 ，以 `<` 或 `>` 開頭的運算符會被分離成兩個或多個標記，剩餘部分以同樣的方式會被再次分離。因此，在 `Dictionary>` 中沒有必要添加空白來消除閉合字符 `>` 的歧義。在這個例子中， 閉合字符 `>` 被看作單字符標記，而不會被誤解為移位運算符 `>>`。 + +要學習如何自定義新的運算符，請參考 [自定義操作符](https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/AdvancedOperators.html#//apple_ref/doc/uid/TP40014097-CH27-XID_48) 和 [運算符聲明](https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/Declarations.html#//apple_ref/doc/uid/TP40014097-CH34-XID_644)。學習如何重寫現有運算符，請參考 [運算符方法](https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/AdvancedOperators.html#//apple_ref/doc/uid/TP40014097-CH27-XID_43)。 + +> 運算符語法語法 +> *運算符* → [*運算符字符*](LexicalStructure.html#operator_character) [*運算符*](LexicalStructure.html#operator) _可選_ +> *運算符字符* → **/** | **=** | **-** | **+** | **!** | ***** | **%** | **<** | **>** | **&** | **|** | **^** | **~** | **.** +> *二元運算符* → [*運算符*](LexicalStructure.html#operator) +> *前置運算符* → [*運算符*](LexicalStructure.html#operator) +> *後置運算符* → [*運算符*](LexicalStructure.html#operator) diff --git a/source-tw/chapter3/03_Types.md b/source-tw/chapter3/03_Types.md new file mode 100644 index 00000000..778a545e --- /dev/null +++ b/source-tw/chapter3/03_Types.md @@ -0,0 +1,300 @@ +> 翻譯：[lyuka](https://github.com/lyuka) +> 校對：[numbbbbb](https://github.com/numbbbbb), [stanzhai](https://github.com/stanzhai) + +# 類型（Types） +----------------- + +本頁包含內容： + +- [類型註解（Type Annotation）](#type_annotation) +- [類型標識符（Type Identifier）](#type_identifier) +- [元組類型（Tuple Type）](#tuple_type) +- [函數類型（Function Type）](#function_type) +- [數組類型（Array Type）](#array_type) +- [可選類型（Optional Type）](#optional_type) +- [隱式解析可選類型（Implicitly Unwrapped Optional Type）](#implicitly_unwrapped_optional_type) +- [協議合成類型（Protocol Composition Type）](#protocol_composition_type) +- [元類型（Metatype Type）](#metatype_type) +- [類型繼承子句（Type Inheritance Clause）](#type_inheritance_clause) +- [類型推斷（Type Inference）](#type_inference) + +Swift 語言存在兩種類型：命名型類型和複合型類型。*命名型類型*是指定義時可以給定名字的類型。命名型類型包括類、結構體、枚舉和協議。比如，一個用戶定義的類`MyClass`的實例擁有類型`MyClass`。除了用戶定義的命名型類型，Swift 標準庫也定義了很多常用的命名型類型，包括那些表示數組、字典和可選值的類型。 + +那些通常被其它語言認為是基本或初級的數據型類型（Data types）——比如表示數字、字符和字符串——實際上就是命名型類型，Swift 標準庫是使用結構體定義和實現它們的。因為它們是命名型類型，因此你可以按照「擴展和擴展聲明」章節裡討論的那樣，聲明一個擴展來增加它們的行為以適應你程序的需求。 + +*複合型類型*是沒有名字的類型，它由 Swift 本身定義。Swift 存在兩種複合型類型：函數類型和元組類型。一個複合型類型可以包含命名型類型和其它複合型類型。例如，元組類型`(Int, (Int, Int))`包含兩個元素：第一個是命名型類型`Int`，第二個是另一個複合型類型`(Int, Int)`. + +本節討論 Swift 語言本身定義的類型，並描述 Swift 中的類型推斷行為。 + +> 類型語法 +> *類型* → [*數組類型*](..\chapter3\03_Types.html#array_type) | [*函數類型*](..\chapter3\03_Types.html#function_type) | [*類型標識*](..\chapter3\03_Types.html#type_identifier) | [*元組類型*](..\chapter3\03_Types.html#tuple_type) | [*可選類型*](..\chapter3\03_Types.html#optional_type) | [*隱式解析可選類型*](..\chapter3\03_Types.html#implicitly_unwrapped_optional_type) | [*協議合成類型*](..\chapter3\03_Types.html#protocol_composition_type) | [*元型類型*](..\chapter3\03_Types.html#metatype_type) + + +##類型註解 + +類型註解顯式地指定一個變量或表達式的值。類型註解始於冒號`:`終於類型，比如下面兩個例子： + +```swift +let someTuple: (Double, Double) = (3.14159, 2.71828) +func someFunction(a: Int){ /* ... */ } +``` +在第一個例子中，表達式`someTuple`的類型被指定為`(Double, Double)`。在第二個例子中，函數`someFunction`的參數`a`的類型被指定為`Int`。 + +類型註解可以在類型之前包含一個類型特性（type attributes）的可選列表。 + +> 類型註解語法 +> *類型註解* → **:** [*特性(Attributes)列表*](..\chapter3\06_Attributes.html#attributes) _可選_ [*類型*](..\chapter3\03_Types.html#type) + + +##類型標識符 + +類型標識符引用命名型類型或者是命名型/複合型類型的別名。 + +大多數情況下，類型標識符引用的是同名的命名型類型。例如類型標識符`Int`引用命名型類型`Int`，同樣，類型標識符`Dictionary`引用命名型類型`Dictionary`。 + +在兩種情況下類型標識符引用的不是同名的類型。情況一，類型標識符引用的是命名型/複合型類型的類型別名。比如，在下面的例子中，類型標識符使用`Point`來引用元組`(Int, Int)`： + +```swift +typealias Point = (Int, Int) +let origin: Point = (0, 0) +``` + +情況二，類型標識符使用dot(`.`)語法來表示在其它模塊（modules）或其它類型嵌套內聲明的命名型類型。例如，下面例子中的類型標識符引用在`ExampleModule`模塊中聲明的命名型類型`MyType`： + +```swift +var someValue: ExampleModule.MyType +``` + +> 類型標識語法 +> *類型標識* → [*類型名稱*](..\chapter3\03_Types.html#type_name) [*泛型參數子句*](GenericParametersAndArguments.html#generic_argument_clause) _可選_ | [*類型名稱*](..\chapter3\03_Types.html#type_name) [*泛型參數子句*](GenericParametersAndArguments.html#generic_argument_clause) _可選_ **.** [*類型標識*](..\chapter3\03_Types.html#type_identifier) +> *類名* → [*標識符*](LexicalStructure.html#identifier) + + +##元組類型 + +元組類型使用逗號隔開並使用括號括起來的0個或多個類型組成的列表。 + +你可以使用元組類型作為一個函數的返回類型，這樣就可以使函數返回多個值。你也可以命名元組類型中的元素，然後用這些名字來引用每個元素的值。元素的名字由一個標識符和`:`組成。「函數和多返回值」章節裡有一個展示上述特性的例子。 + +`void`是空元組類型`()`的別名。如果括號內只有一個元素，那麼該類型就是括號內元素的類型。比如，`(Int)`的類型是`Int`而不是`(Int)`。所以，只有當元組類型包含兩個元素以上時才可以標記元組元素。 + +> 元組類型語法 +> *元組類型* → **(** [*元組類型主體*](..\chapter3\03_Types.html#tuple_type_body) _可選_ **)** +> *元組類型主體* → [*元組類型的元素列表*](..\chapter3\03_Types.html#tuple_type_element_list) **...** _可選_ +> *元組類型的元素列表* → [*元組類型的元素*](..\chapter3\03_Types.html#tuple_type_element) | [*元組類型的元素*](..\chapter3\03_Types.html#tuple_type_element) **,** [*元組類型的元素列表*](..\chapter3\03_Types.html#tuple_type_element_list) +> *元組類型的元素* → [*特性(Attributes)列表*](..\chapter3\06_Attributes.html#attributes) _可選_ **inout** _可選_ [*類型*](..\chapter3\03_Types.html#type) | **inout** _可選_ [*元素名*](..\chapter3\03_Types.html#element_name) [*類型註解*](..\chapter3\03_Types.html#type_annotation) +> *元素名* → [*標識符*](LexicalStructure.html#identifier) + + +##函數類型 + +函數類型表示一個函數、方法或閉包的類型，它由一個參數類型和返回值類型組成，中間用箭頭`->`隔開： + +- `parameter type` -> `return type` + +由於 *參數類型* 和 *返回值類型* 可以是元組類型，所以函數類型可以讓函數與方法支持多參數與多返回值。 + +你可以對函數類型應用帶有參數類型`()`並返回表達式類型的`auto_closure`屬性（見類型屬性章節）。一個自動閉包涵數捕獲特定表達式上的隱式閉包而非表達式本身。下面的例子使用`auto_closure`屬性來定義一個很簡單的assert函數： + +```swift +func simpleAssert(condition: @auto_closure () -> Bool, message: String){ + if !condition(){ + println(message) + } +} +let testNumber = 5 +simpleAssert(testNumber % 2 == 0, "testNumber isn't an even number.") +// prints "testNumber isn't an even number." +``` +函數類型可以擁有一個可變長參數作為參數類型中的最後一個參數。從語法角度上講，可變長參數由一個基礎類型名字和`...`組成，如`Int...`。可變長參數被認為是一個包含了基礎類型元素的數組。即`Int...`就是`Int[]`。關於使用可變長參數的例子，見章節「可變長參數」。 + +為了指定一個`in-out`參數，可以在參數類型前加`inout`前綴。但是你不可以對可變長參數或返回值類型使用`inout`。關於In-Out參數的討論見章節In-Out參數部分。 + +柯裡化函數（curried function）的類型相當於一個嵌套函數類型。例如，下面的柯裡化函數`addTwoNumber()()`的類型是`Int -> Int -> Int`： + +```swift +func addTwoNumbers(a: Int)(b: Int) -> Int{ + return a + b +} +addTwoNumbers(4)(5) // returns 9 +``` + +柯裡化函數的函數類型從右向左組成一組。例如，函數類型`Int -> Int -> Int`可以被理解為`Int -> (Int -> Int)`——也就是說，一個函數傳入一個`Int`然後輸出作為另一個函數的輸入，然後又返回一個`Int`。例如，你可以使用如下嵌套函數來重寫柯裡化函數`addTwoNumbers()()`： + +```swift +func addTwoNumbers(a: Int) -> (Int -> Int){ + func addTheSecondNumber(b: Int) -> Int{ + return a + b + } + return addTheSecondNumber +} +addTwoNumbers(4)(5) // Returns 9 +``` + +> 函數類型語法 +> *函數類型* → [*類型*](..\chapter3\03_Types.html#type) **->** [*類型*](..\chapter3\03_Types.html#type) + + +##數組類型 + +Swift語言使用類型名緊接中括號`[]`來簡化標準庫中定義的命名型類型`Array`。換句話說，下面兩個聲明是等價的： + +```swift +let someArray: String[] = ["Alex", "Brian", "Dave"] +let someArray: Array = ["Alex", "Brian", "Dave"] +``` +上面兩種情況下，常量`someArray`都被聲明為字符串數組。數組的元素也可以通過`[]`獲取訪問：`someArray[0]`是指第0個元素`「Alex」`。 + +上面的例子同時顯示，你可以使用`[]`作為初始值構造數組，空的`[]`則用來來構造指定類型的空數組。 + +```swift +var emptyArray: Double[] = [] +``` +你也可以使用鏈接起來的多個`[]`集合來構造多維數組。例如，下例使用三個`[]`集合來構造三維整型數組： + +```swift +var array3D: Int[][][] = [[[1, 2], [3, 4]], [[5, 6], [7, 8]]] +``` +訪問一個多維數組的元素時，最左邊的下標指向最外層數組的相應位置元素。接下來往右的下標指向第一層嵌入的相應位置元素，依次類推。這就意味著，在上面的例子中，`array3D[0]`是指`[[1, 2], [3, 4]]`，`array3D[0][1]`是指`[3, 4]`，`array3D[0][1][1]`則是指值`4`。 + +關於Swift標準庫中`Array`類型的細節討論，見章節Arrays。 + +> 數組類型語法 +> *數組類型* → [*類型*](..\chapter3\03_Types.html#type) **[** **]** | [*數組類型*](..\chapter3\03_Types.html#array_type) **[** **]** + + +##可選類型 + +Swift定義後綴`?`來作為標準庫中的定義的命名型類型`Optional`的簡寫。換句話說，下面兩個聲明是等價的： + +```swift +var optionalInteger: Int? +var optionalInteger: Optional +``` +在上述兩種情況下，變量`optionalInteger`都被聲明為可選整型類型。注意在類型和`?`之間沒有空格。 + +類型`Optional`是一個枚舉，有兩種形式，`None`和`Some(T)`，又來代表可能出現或可能不出現的值。任意類型都可以被顯式的聲明（或隱式的轉換）為可選類型。當聲明一個可選類型時，確保使用括號給`?`提供合適的作用範圍。比如說，聲明一個整型的可選數組，應寫作`(Int[])?`，寫成`Int[]?`的話則會出錯。 + +如果你在聲明或定義可選變量或特性的時候沒有提供初始值，它的值則會自動賦成缺省值`nil`。 + +可選符合`LogicValue`協議，因此可以出現在布爾值環境下。此時，如果一個可選類型`T?`實例包含有類型為`T`的值（也就是說值為`Optional.Some(T)`），那麼此可選類型就為`true`，否則為`false`。 + +如果一個可選類型的實例包含一個值，那麼你就可以使用後綴操作符`!`來獲取該值，正如下面描述的： + +```swift +optionalInteger = 42 +optionalInteger! // 42 +``` +使用`!`操作符獲取值為`nil`的可選項會導致運行錯誤（runtime error）。 + +你也可以使用可選鏈和可選綁定來選擇性的執行可選表達式上的操作。如果值為`nil`，不會執行任何操作因此也就沒有運行錯誤產生。 + +更多細節以及更多如何使用可選類型的例子，見章節「可選」。 + +> 可選類型語法 +> *可選類型* → [*類型*](..\chapter3\03_Types.html#type) **?** + + +##隱式解析可選類型 + +Swift語言定義後綴`!`作為標準庫中命名類型`ImplicitlyUnwrappedOptional`的簡寫。換句話說，下面兩個聲明等價： + +```swift +var implicitlyUnwrappedString: String! +var implicitlyUnwrappedString: ImplicitlyUnwrappedOptional +``` +上述兩種情況下，變量`implicitlyUnwrappedString`被聲明為一個隱式解析可選類型的字符串。注意類型與`!`之間沒有空格。 + +你可以在使用可選的地方同樣使用隱式解析可選。比如，你可以將隱式解析可選的值賦給變量、常量和可選特性，反之亦然。 + +有了可選，你在聲明隱式解析可選變量或特性的時候就不用指定初始值，因為它有缺省值`nil`。 + +由於隱式解析可選的值會在使用時自動解析，所以沒必要使用操作符`!`來解析它。也就是說，如果你使用值為`nil`的隱式解析可選，就會導致運行錯誤。 + +使用可選鏈會選擇性的執行隱式解析可選表達式上的某一個操作。如果值為`nil`，就不會執行任何操作，因此也不會產生運行錯誤。 + +關於隱式解析可選的更多細節，見章節「隱式解析可選」。 + +> 隱式解析可選類型(Implicitly Unwrapped Optional Type)語法 +> *隱式解析可選類型* → [*類型*](..\chapter3\03_Types.html#type) **!** + + +##協議合成類型 + +協議合成類型是一種符合每個協議的指定協議列表類型。協議合成類型可能會用在類型註解和泛型參數中。 + +協議合成類型的形式如下： + +```swift +protocol +``` + +協議合成類型允許你指定一個值，其類型可以適配多個協議的條件，而且不需要定義一個新的命名型協議來繼承其它想要適配的各個協議。比如，協議合成類型`protocol`等效於一個從`Protocol A`，`Protocol B`， `Protocol C`繼承而來的新協議`Protocol D`，很顯然這樣做有效率的多，甚至不需引入一個新名字。 + +協議合成列表中的每項必須是協議名或協議合成類型的類型別名。如果列表為空，它就會指定一個空協議合成列表，這樣每個類型都能適配。 + +> 協議合成類型語法 +> *協議合成類型* → **protocol** **<** [*協議標識符列表*](..\chapter3\03_Types.html#protocol_identifier_list) _可選_ **>** +> *協議標識符列表* → [*協議標識符*](..\chapter3\03_Types.html#protocol_identifier) | [*協議標識符*](..\chapter3\03_Types.html#protocol_identifier) **,** [*協議標識符列表*](..\chapter3\03_Types.html#protocol_identifier_list) +> *協議標識符* → [*類型標識*](..\chapter3\03_Types.html#type_identifier) + + +##元類型 + +元類型是指所有類型的類型，包括類、結構體、枚舉和協議。 + +類、結構體或枚舉類型的元類型是相應的類型名緊跟`.Type`。協議類型的元類型——並不是運行時適配該協議的具體類型——是該協議名字緊跟`.Protocol`。比如，類`SomeClass`的元類型就是`SomeClass.Type`，協議`SomeProtocol`的元類型就是`SomeProtocal.Protocol`。 + +你可以使用後綴`self`表達式來獲取類型。比如，`SomeClass.self`返回`SomeClass`本身，而不是`SomeClass`的一個實例。同樣，`SomeProtocol.self`返回`SomeProtocol`本身，而不是運行時適配`SomeProtocol`的某個類型的實例。還可以對類型的實例使用`dynamicType`表達式來獲取該實例在運行階段的類型，如下所示： + +```swift +class SomeBaseClass { + class func printClassName() { + println("SomeBaseClass") + } +} +class SomeSubClass: SomeBaseClass { + override class func printClassName() { + println("SomeSubClass") + } +} +let someInstance: SomeBaseClass = SomeSubClass() +// someInstance is of type SomeBaseClass at compile time, but +// someInstance is of type SomeSubClass at runtime +someInstance.dynamicType.printClassName() +// prints "SomeSubClass +``` + +> 元(Metatype)類型語法 +> *元類型* → [*類型*](..\chapter3\03_Types.html#type) **.** **Type** | [*類型*](..\chapter3\03_Types.html#type) **.** **Protocol** x + + +##類型繼承子句 + +類型繼承子句被用來指定一個命名型類型繼承哪個類且適配哪些協議。類型繼承子句開始於冒號`:`，緊跟由`,`隔開的類型標識符列表。 + +類可以繼承單個超類，適配任意數量的協議。當定義一個類時，超類的名字必須出現在類型標識符列表首位，然後跟上該類需要適配的任意數量的協議。如果一個類不是從其它類繼承而來，那麼列表可以以協議開頭。關於類繼承更多的討論和例子，見章節「繼承」。 + +其它命名型類型可能只繼承或適配一個協議列表。協議類型可能繼承於其它任意數量的協議。當一個協議類型繼承於其它協議時，其它協議的條件集合會被集成在一起，然後其它從當前協議繼承的任意類型必須適配所有這些條件。 + +枚舉定義中的類型繼承子句可以是一個協議列表，或是指定原始值的枚舉，一個單獨的指定原始值類型的命名型類型。使用類型繼承子句來指定原始值類型的枚舉定義的例子，見章節「原始值」。 + +> 類型繼承子句語法 +> *類型繼承子句* → **:** [*類型繼承列表*](..\chapter3\03_Types.html#type_inheritance_list) +> *類型繼承列表* → [*類型標識*](..\chapter3\03_Types.html#type_identifier) | [*類型標識*](..\chapter3\03_Types.html#type_identifier) **,** [*類型繼承列表*](..\chapter3\03_Types.html#type_inheritance_list) + + +##類型推斷 + +Swift廣泛的使用類型推斷，從而允許你可以忽略很多變量和表達式的類型或部分類型。比如，對於`var x: Int = 0`，你可以完全忽略類型而簡寫成`var x = 0`——編譯器會正確的推斷出`x`的類型`Int`。類似的，當完整的類型可以從上下文推斷出來時，你也可以忽略類型的一部分。比如，如果你寫了`let dict: Dictionary = ["A": 1]`，編譯提也能推斷出`dict`的類型是`Dictionary`。 + +在上面的兩個例子中，類型信息從表達式樹（expression tree）的葉子節點傳向根節點。也就是說，`var x: Int = 0`中`x`的類型首先根據`0`的類型進行推斷，然後將該類型信息傳遞到根節點（變量`x`）。 + +在Swift中，類型信息也可以反方向流動——從根節點傳向葉子節點。在下面的例子中，常量`eFloat`上的顯式類型註解（`:Float`）導致數字字面量`2.71828`的類型是`Float`而非`Double`。 + +```swift +let e = 2.71828 // The type of e is inferred to be Double. +let eFloat: Float = 2.71828 // The type of eFloat is Float. +``` + +Swift中的類型推斷在單獨的表達式或語句水平上進行。這意味著所有用於推斷類型的信息必須可以從表達式或其某個子表達式的類型檢查中獲取。 diff --git a/source-tw/chapter3/04_Expressions.md b/source-tw/chapter3/04_Expressions.md new file mode 100644 index 00000000..c368d9d4 --- /dev/null +++ b/source-tw/chapter3/04_Expressions.md @@ -0,0 +1,637 @@ +> 翻譯：[sg552](https://github.com/sg552) +> 校對：[numbbbbb](https://github.com/numbbbbb), [stanzhai](https://github.com/stanzhai) + +# 表達式（Expressions） +----------------- + +本頁包含內容： + +- [前綴表達式（Prefix Expressions）](#prefix_expressions) +- [二元表達式（Binary Expressions）](#binary_expressions) +- [賦值表達式（Assignment Operator）](#assignment_operator) +- [三元條件運算符（Ternary Conditional Operator）](#ternary_conditional_operator) +- [類型轉換運算符（Type-Casting Operators）](#type-casting_operators) +- [主要表達式（Primary Expressions）](#primary_expressions) +- [後綴表達式（Postfix Expressions）](#postfix_expressions) + +Swift 中存在四種表達式： 前綴（prefix）表達式，二元（binary）表達式，主要（primary）表達式和後綴（postfix）表達式。表達式可以返回一個值，以及運行某些邏輯（causes a side effect）。 + +前綴表達式和二元表達式就是對某些表達式使用各種運算符（operators）。 主要表達式是最短小的表達式，它提供了獲取（變量的）值的一種途徑。 後綴表達式則允許你建立複雜的表達式，例如配合函數調用和成員訪問。 每種表達式都在下面有詳細論述～ + +> 表達式語法 +> *表達式* → [*前置表達式*](..\chapter3\04_Expressions.html#prefix_expression) [*二元表達式列表*](..\chapter3\04_Expressions.html#binary_expressions) _可選_ +> *表達式列表* → [*表達式*](..\chapter3\04_Expressions.html#expression) | [*表達式*](..\chapter3\04_Expressions.html#expression) **,** [*表達式列表*](..\chapter3\04_Expressions.html#expression_list) + + +## 前綴表達式（Prefix Expressions） + +前綴表達式由 前綴符號和表達式組成。（這個前綴符號只能接收一個參數） + +Swift 標準庫支持如下的前綴操作符： + +- ++ 自增1 （increment） +- -- 自減1 （decrement） +- ! 邏輯否 （Logical NOT ） +- ~ 按位否 （Bitwise NOT ） +- \+ 加（Unary plus） +- \- 減（Unary minus） + +對於這些操作符的使用，請參見： Basic Operators and Advanced Operators + +作為對上面標準庫運算符的補充，你也可以對 某個函數的參數使用 '&'運算符。 更多信息，請參見： "In-Out parameters". + +> 前置表達式語法 +> *前置表達式* → [*前置運算符*](LexicalStructure.html#prefix_operator) _可選_ [*後置表達式*](..\chapter3\04_Expressions.html#postfix_expression) +> *前置表達式* → [*寫入寫出(in-out)表達式*](..\chapter3\04_Expressions.html#in_out_expression) +> *寫入寫出(in-out)表達式* → **&** [*標識符*](LexicalStructure.html#identifier) + + +## 二元表達式（Binary Expressions） + +二元表達式由 "左邊參數" + "二元運算符" + "右邊參數" 組成, 它有如下的形式： + +> `left-hand argument` `operator` `right-hand argument` + +Swift 標準庫提供了如下的二元運算符： + +- 求冪相關（無結合，優先級160） + - << 按位左移（Bitwise left shift） + - >> 按位右移（Bitwise right shift） +- 乘除法相關（左結合，優先級150） + - \* 乘 + - / 除 + - % 求余 + - &* 乘法，忽略溢出（ Multiply, ignoring overflow） + - &/ 除法，忽略溢出（Divide, ignoring overflow） + - &% 求余, 忽略溢出（ Remainder, ignoring overflow） + - & 位與（ Bitwise AND） +- 加減法相關（左結合, 優先級140） + - \+ 加 + - \- 減 + - &+ Add with overflow + - &- Subtract with overflow + - | 按位或（Bitwise OR ） + - ^ 按位異或（Bitwise XOR） +- Range （無結合,優先級 135） + - .. 半閉值域 Half-closed range + - ... 全閉值域 Closed range +- 類型轉換 （無結合,優先級 132） + - is 類型檢查（ type check） + - as 類型轉換（ type cast） +- Comparative （無結合,優先級 130） + - < 小於 + - <= 小於等於 + - > 大於 + - >= 大於等於 + - == 等於 + - != 不等 + - === 恆等於 + - !== 不恆等 + - ~= 模式匹配（ Pattern match） +- 合取（ Conjunctive） （左結合,優先級 120） + - && 邏輯與（Logical AND） +- 析取（Disjunctive） （左結合,優先級 110） + - || 邏輯或（ Logical OR） +- 三元條件（Ternary Conditional ）（右結合,優先級 100） + - ?: 三元條件 Ternary conditional +- 賦值 （Assignment） （右結合, 優先級 90） + - = 賦值（Assign） + - *= Multiply and assign + - /= Divide and assign + - %= Remainder and assign + - += Add and assign + - -= Subtract and assign + - <<= Left bit shift and assign + - >>= Right bit shift and assign + - &= Bitwise AND and assign + - ^= Bitwise XOR and assign + - |= Bitwise OR and assign + - &&= Logical AND and assign + - ||= Logical OR and assign + +關於這些運算符（operators）的更多信息，請參見：Basic Operators and Advanced Operators. + +> 注意 +> 在解析時, 一個二元表達式表示為一個一級數組（a flat list）, 這個數組（List）根據運算符的先後順序，被轉換成了一個tree. 例如： 2 + 3 * 5 首先被認為是： 2, + , `` 3``, *, 5. 隨後它被轉換成 tree （2 + （3 * 5）） + +

+ +> 二元表達式語法 +> *二元表達式* → [*二元運算符*](LexicalStructure.html#binary_operator) [*前置表達式*](..\chapter3\04_Expressions.html#prefix_expression) +> *二元表達式* → [*賦值運算符*](..\chapter3\04_Expressions.html#assignment_operator) [*前置表達式*](..\chapter3\04_Expressions.html#prefix_expression) +> *二元表達式* → [*條件運算符*](..\chapter3\04_Expressions.html#conditional_operator) [*前置表達式*](..\chapter3\04_Expressions.html#prefix_expression) +> *二元表達式* → [*類型轉換運算符*](..\chapter3\04_Expressions.html#type_casting_operator) +> *二元表達式列表* → [*二元表達式*](..\chapter3\04_Expressions.html#binary_expression) [*二元表達式列表*](..\chapter3\04_Expressions.html#binary_expressions) _可選_ + + + +## 賦值表達式（Assignment Operator） + +賦值表達式會對某個給定的表達式賦值。 它有如下的形式； + +> `expression` = `value` + +就是把右邊的 *value* 賦值給左邊的 *expression*. 如果左邊的*expression* 需要接收多個參數（是一個tuple ），那麼右邊必須也是一個具有同樣數量參數的tuple. （允許嵌套的tuple） + +```swift +(a, _, (b, c)) = ("test", 9.45, (12, 3)) +// a is "test", b is 12, c is 3, and 9.45 is ignored +``` + +賦值運算符不返回任何值。 + +> 賦值運算符語法 +> *賦值運算符* → **=** + + +## 三元條件運算符（Ternary Conditional Operator） + +三元條件運算符 是根據條件來獲取值。 形式如下： + +> `condition` ? `expression used if true` : `expression used if false` + +如果 `condition` 是true, 那麼返回 第一個表達式的值（此時不會調用第二個表達式）， 否則返回第二個表達式的值（此時不會調用第一個表達式）。 + +想看三元條件運算符的例子，請參見： Ternary Conditional Operator. + +> 三元條件運算符語法 +> *三元條件運算符* → **?** [*表達式*](..\chapter3\04_Expressions.html#expression) **:** + + +## 類型轉換運算符（Type-Casting Operators） + +有兩種類型轉換操作符： as 和 is. 它們有如下的形式： + +> `expression` as `type` +> `expression` as? `type` +> `expression` is `type` + +as 運算符會把`目標表達式`轉換成指定的`類型`（specified type），過程如下： + +- 如果類型轉換成功， 那麼目標表達式就會返回指定類型的實例（instance）. 例如：把子類（subclass）變成父類（superclass）時. +- 如果轉換失敗，則會拋出編譯錯誤（ compile-time error）。 +- 如果上述兩個情況都不是（也就是說，編譯器在編譯時期無法確定轉換能否成功，） 那麼目標表達式就會變成指定的類型的optional. （is an optional of the specified type ） 然後在運行時，如果轉換成功， 目標表達式就會作為 optional的一部分來返回， 否則，目標表達式返回nil. 對應的例子是： 把一個 superclass 轉換成一個 subclass. + +```swift +class SomeSuperType {} +class SomeType: SomeSuperType {} +class SomeChildType: SomeType {} +let s = SomeType() + +let x = s as SomeSuperType // known to succeed; type is SomeSuperType +let y = s as Int // known to fail; compile-time error +let z = s as SomeChildType // might fail at runtime; type is SomeChildType? +``` + +使用'as'做類型轉換跟正常的類型聲明，對於編譯器來說是一樣的。例如： + +```swift +let y1 = x as SomeType // Type information from 'as' +let y2: SomeType = x // Type information from an annotation +``` + +'is' 運算符在「運行時（runtime）」會做檢查。 成功會返回true, 否則 false + +上述檢查在「編譯時（compile time）」不能使用。 例如下面的使用是錯誤的： + +```swift +"hello" is String +"hello" is Int +``` + +關於類型轉換的更多內容和例子，請參見： Type Casting. + +> 類型轉換運算符(type-casting-operator)語法 +> *類型轉換運算符* → **is** [*類型*](..\chapter3\03_Types.html#type) | **as** **?** _可選_ [*類型*](..\chapter3\03_Types.html#type) + + +## 主表達式（Primary Expressions） + +`主表達式`是最基本的表達式。 它們可以跟 前綴表達式，二元表達式，後綴表達式以及其他主要表達式組合使用。 + +> 主表達式語法 +> *主表達式* → [*標識符*](LexicalStructure.html#identifier) [*泛型參數子句*](GenericParametersAndArguments.html#generic_argument_clause) _可選_ +> *主表達式* → [*字面量表達式*](..\chapter3\04_Expressions.html#literal_expression) +> *主表達式* → [*self表達式*](..\chapter3\04_Expressions.html#self_expression) +> *主表達式* → [*超類表達式*](..\chapter3\04_Expressions.html#superclass_expression) +> *主表達式* → [*閉包表達式*](..\chapter3\04_Expressions.html#closure_expression) +> *主表達式* → [*圓括號表達式*](..\chapter3\04_Expressions.html#parenthesized_expression) +> *主表達式* → [*隱式成員表達式*](..\chapter3\04_Expressions.html#implicit_member_expression) +> *主表達式* → [*通配符表達式*](..\chapter3\04_Expressions.html#wildcard_expression) + +### 字符型表達式（Literal Expression） + +由這些內容組成：普通的字符（string, number） , 一個字符的字典或者數組，或者下面列表中的特殊字符。 + +字符（Literal） | 類型（Type） | 值（Value） +------------- | ---------- | ---------- +\__FILE__ | String | 所在的文件名 +\__LINE__ | Int | 所在的行數 +\__COLUMN__ | Int | 所在的列數 +\__FUNCTION__ | String | 所在的function 的名字 + +在某個函數（function）中，`__FUNCTION__` 會返回當前函數的名字。 在某個方法（method）中，它會返回當前方法的名字。 在某個property 的getter/setter中會返回這個屬性的名字。 在特殊的成員如init/subscript中 會返回這個關鍵字的名字，在某個文件的頂端（the top level of a file），它返回的是當前module的名字。 + +一個array literal，是一個有序的值的集合。 它的形式是： + +> [`value 1`, `value 2`, `...`] + +數組中的最後一個表達式可以緊跟一個逗號（','）. []表示空數組 。 array literal的type是 T[], 這個T就是數組中元素的type. 如果該數組中有多種type, T則是跟這些type的公共supertype最接近的type.（closest common supertype） + +一個`dictionary literal` 是一個包含無序的鍵值對（key-value pairs）的集合，它的形式是: + +> [`key 1`: `value 1`, `key 2`: `value 2`, `...`] + +dictionary 的最後一個表達式可以是一個逗號（','）. [:] 表示一個空的dictionary. 它的type是 Dictionary （這裡KeyType表示 key的type, ValueType表示 value的type） 如果這個dictionary 中包含多種 types, 那麼KeyType, Value 則對應著它們的公共supertype最接近的type（ closest common supertype）. + +> 字面量表達式語法 +> *字面量表達式* → [*字面量*](LexicalStructure.html#literal) +> *字面量表達式* → [*數組字面量*](..\chapter3\04_Expressions.html#array_literal) | [*字典字面量*](..\chapter3\04_Expressions.html#dictionary_literal) +> *字面量表達式* → **__FILE__** | **__LINE__** | **__COLUMN__** | **__FUNCTION__** +> *數組字面量* → **[** [*數組字面量項列表*](..\chapter3\04_Expressions.html#array_literal_items) _可選_ **]** +> *數組字面量項列表* → [*數組字面量項*](..\chapter3\04_Expressions.html#array_literal_item) **,** _可選_ | [*數組字面量項*](..\chapter3\04_Expressions.html#array_literal_item) **,** [*數組字面量項列表*](..\chapter3\04_Expressions.html#array_literal_items) +> *數組字面量項* → [*表達式*](..\chapter3\04_Expressions.html#expression) +> *字典字面量* → **[** [*字典字面量項列表*](..\chapter3\04_Expressions.html#dictionary_literal_items) **]** | **[** **:** **]** +> *字典字面量項列表* → [*字典字面量項*](..\chapter3\04_Expressions.html#dictionary_literal_item) **,** _可選_ | [*字典字面量項*](..\chapter3\04_Expressions.html#dictionary_literal_item) **,** [*字典字面量項列表*](..\chapter3\04_Expressions.html#dictionary_literal_items) +> *字典字面量項* → [*表達式*](..\chapter3\04_Expressions.html#expression) **:** [*表達式*](..\chapter3\04_Expressions.html#expression) + +### self表達式（Self Expression） + +self表達式是對 當前type 或者當前instance的引用。它的形式如下： + +> self +> self.`member name` +> self[`subscript index`] +> self（`initializer arguments`） +> self.init（`initializer arguments`） + +如果在 initializer, subscript, instance method中，self等同於當前type的instance. 在一個靜態方法（static method）, 類方法（class method）中， self等同於當前的type. + +當訪問 member（成員變量時）， self 用來區分重名變量（例如函數的參數）. 例如， +（下面的 self.greeting 指的是 var greeting: String, 而不是 init（greeting: String） ） + +```swift +class SomeClass { + var greeting: String + init（greeting: String） { + self.greeting = greeting + } +} +``` + +在mutating 方法中， 你可以使用self 對 該instance進行賦值。 + +```swift +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） + } +} +``` + +> Self 表達式語法 +> *self表達式* → **self** +> *self表達式* → **self** **.** [*標識符*](LexicalStructure.html#identifier) +> *self表達式* → **self** **[** [*表達式*](..\chapter3\04_Expressions.html#expression) **]** +> *self表達式* → **self** **.** **init** + +### 超類表達式（Superclass Expression） + +超類表達式可以使我們在某個class中訪問它的超類. 它有如下形式： + +> super.`member name` +> super[`subscript index`] +> super.init（`initializer arguments`） + +形式1 用來訪問超類的某個成員（member）. 形式2 用來訪問該超類的 subscript 實現。 形式3 用來訪問該超類的 initializer. + +子類（subclass）可以通過超類（superclass）表達式在它們的 member, subscripting 和 initializers 中來利用它們超類中的某些實現（既有的方法或者邏輯）。 + +> 超類(superclass)表達式語法 +> *超類表達式* → [*超類方法表達式*](..\chapter3\04_Expressions.html#superclass_method_expression) | [*超類下標表達式*](..\chapter3\04_Expressions.html#超類下標表達式) | [*超類構造器表達式*](..\chapter3\04_Expressions.html#superclass_initializer_expression) +> *超類方法表達式* → **super** **.** [*標識符*](LexicalStructure.html#identifier) +> *超類下標表達式* → **super** **[** [*表達式*](..\chapter3\04_Expressions.html#expression) **]** +> *超類構造器表達式* → **super** **.** **init** + +### 閉包表達式（Closure Expression） + +閉包（closure） 表達式可以建立一個閉包（在其他語言中也叫 lambda, 或者 匿名函數（anonymous function））. 跟函數（function）的聲明一樣， 閉包（closure）包含了可執行的代碼（跟方法主體（statement）類似） 以及接收（capture）的參數。 它的形式如下： + +```swift +{ （parameters） -> return type in + statements +} +``` + +閉包的參數聲明形式跟方法中的聲明一樣, 請參見：Function Declaration. + +閉包還有幾種特殊的形式, 讓使用更加簡潔： + +- 閉包可以省略 它的參數的type 和返回值的type. 如果省略了參數和參數類型，就也要省略 'in'關鍵字。 如果被省略的type 無法被編譯器獲知（inferred） ，那麼就會拋出編譯錯誤。 +- 閉包可以省略參數，轉而在方法體（statement）中使用 $0, $1, $2 來引用出現的第一個，第二個，第三個參數。 +- 如果閉包中只包含了一個表達式，那麼該表達式就會自動成為該閉包的返回值。 在執行 'type inference '時，該表達式也會返回。 + +下面幾個 閉包表達式是 等價的： + +```swift +myFunction { + （x: Int, y: Int） -> Int in + return x + y +} + +myFunction { + （x, y） in + return x + y +} + +myFunction { return $0 + $1 } + +myFunction { $0 + $1 } +``` + +關於 向閉包中傳遞參數的內容，參見： Function Call Expression. + +閉包表達式可以通過一個參數列表（capture list） 來顯式指定它需要的參數。 參數列表 由中括號 [] 括起來，裡面的參數由逗號','分隔。一旦使用了參數列表，就必須使用'in'關鍵字（在任何情況下都得這樣做，包括忽略參數的名字，type, 返回值時等等）。 + +在閉包的參數列表（ capture list）中， 參數可以聲明為 'weak' 或者 'unowned' . + +```swift +myFunction { print（self.title） } // strong capture +myFunction { [weak self] in print（self!.title） } // weak capture +myFunction { [unowned self] in print（self.title） } // unowned capture +``` + +在參數列表中，也可以使用任意表達式來賦值. 該表達式會在 閉包被執行時賦值，然後按照不同的力度來獲取（這句話請慎重理解）。（captured with the specified strength. ） 例如： + +```swift +// Weak capture of "self.parent" as "parent" +myFunction { [weak parent = self.parent] in print（parent!.title） } +``` + +關於閉包表達式的更多信息和例子，請參見： Closure Expressions. + +> 閉包表達式語法 +> *閉包表達式* → **{** [*閉包簽名(Signational)*](..\chapter3\04_Expressions.html#closure_signature) _可選_ [*多條語句(Statements)*](..\chapter3\10_Statements.html#statements) **}** +> *閉包簽名(Signational)* → [*參數子句*](..\chapter3\05_Declarations.html#parameter_clause) [*函數結果*](..\chapter3\05_Declarations.html#function_result) _可選_ **in** +> *閉包簽名(Signational)* → [*標識符列表*](LexicalStructure.html#identifier_list) [*函數結果*](..\chapter3\05_Declarations.html#function_result) _可選_ **in** +> *閉包簽名(Signational)* → [*捕獲(Capature)列表*](..\chapter3\04_Expressions.html#capture_list) [*參數子句*](..\chapter3\05_Declarations.html#parameter_clause) [*函數結果*](..\chapter3\05_Declarations.html#function_result) _可選_ **in** +> *閉包簽名(Signational)* → [*捕獲(Capature)列表*](..\chapter3\04_Expressions.html#capture_list) [*標識符列表*](LexicalStructure.html#identifier_list) [*函數結果*](..\chapter3\05_Declarations.html#function_result) _可選_ **in** +> *閉包簽名(Signational)* → [*捕獲(Capature)列表*](..\chapter3\04_Expressions.html#capture_list) **in** +> *捕獲(Capature)列表* → **[** [*捕獲(Capature)說明符*](..\chapter3\04_Expressions.html#capture_specifier) [*表達式*](..\chapter3\04_Expressions.html#expression) **]** +> *捕獲(Capature)說明符* → **weak** | **unowned** | **unowned(safe)** | **unowned(unsafe)** + +### 隱式成員表達式（Implicit Member Expression） + +在可以判斷出類型（type）的上下文（context）中，隱式成員表達式是訪問某個type的member（ 例如 class method, enumeration case） 的簡潔方法。 它的形式是： + +> .`member name` + +例子： + +```swift +var x = MyEnumeration.SomeValue +x = .AnotherValue +``` + +> 隱式成員表達式語法 +> *隱式成員表達式* → **.** [*標識符*](..\chapter3\02_Lexical_Structure.html#identifier) + +### 圓括號表達式（Parenthesized Expression） + +圓括號表達式由多個子表達式和逗號','組成。 每個子表達式前面可以有 identifier x: 這樣的可選前綴。形式如下： + +>（`identifier 1`: `expression 1`, `identifier 2`: `expression 2`, `...`） + +圓括號表達式用來建立tuples ， 然後把它做為參數傳遞給 function. 如果某個圓括號表達式中只有一個 子表達式，那麼它的type就是 子表達式的type。例如： （1）的 type是Int, 而不是（Int） + +> 圓括號表達式(Parenthesized Expression)語法 +> *圓括號表達式* → **(** [*表達式元素列表*](..\chapter3\04_Expressions.html#expression_element_list) _可選_ **)** +> *表達式元素列表* → [*表達式元素*](..\chapter3\04_Expressions.html#expression_element) | [*表達式元素*](..\chapter3\04_Expressions.html#expression_element) **,** [*表達式元素列表*](..\chapter3\04_Expressions.html#expression_element_list) +> *表達式元素* → [*表達式*](..\chapter3\04_Expressions.html#expression) | [*標識符*](..\chapter3\02_Lexical_Structure.html#identifier) **:** [*表達式*](..\chapter3\04_Expressions.html#expression) + +### 通配符表達式（Wildcard Expression） + +通配符表達式用來忽略傳遞進來的某個參數。例如：下面的代碼中，10被傳遞給x, 20被忽略（譯註：好奇葩的語法。。。） + +```swift +（x, _） = （10, 20） +// x is 10, 20 is ignored +``` + +> 通配符表達式語法 +> *通配符表達式* → **_** + + +## 後綴表達式（Postfix Expressions） + +後綴表達式就是在某個表達式的後面加上 操作符。 嚴格的講，每個主要表達式（primary expression）都是一個後綴表達式 + +Swift 標準庫提供了下列後綴表達式： + +- ++ Increment +- -- Decrement + +對於這些操作符的使用，請參見： Basic Operators and Advanced Operators + +> 後置表達式語法 +> *後置表達式* → [*主表達式*](..\chapter3\04_Expressions.html#primary_expression) +> *後置表達式* → [*後置表達式*](..\chapter3\04_Expressions.html#postfix_expression) [*後置運算符*](..\chapter3\02_Lexical_Structure.html#postfix_operator) +> *後置表達式* → [*函數調用表達式*](..\chapter3\04_Expressions.html#function_call_expression) +> *後置表達式* → [*構造器表達式*](..\chapter3\04_Expressions.html#initializer_expression) +> *後置表達式* → [*顯示成員表達式*](..\chapter3\04_Expressions.html#explicit_member_expression) +> *後置表達式* → [*後置self表達式*](..\chapter3\04_Expressions.html#postfix_self_expression) +> *後置表達式* → [*動態類型表達式*](..\chapter3\04_Expressions.html#dynamic_type_expression) +> *後置表達式* → [*下標表達式*](..\chapter3\04_Expressions.html#subscript_expression) +> *後置表達式* → [*強制取值(Forced Value)表達式*](..\chapter3\04_Expressions.html#forced_value_expression) +> *後置表達式* → [*可選鏈(Optional Chaining)表達式*](..\chapter3\04_Expressions.html#optional_chaining_expression) + +### 函數調用表達式（Function Call Expression） + +函數調用表達式由函數名和參數列表組成。它的形式如下： + +> `function name`（`argument value 1`, `argument value 2`） + +The function name can be any expression whose value is of a function type. +（不用翻譯了, 太囉嗦） + +如果該function 的聲明中指定了參數的名字，那麼在調用的時候也必須得寫出來. 例如： + +> `function name`（`argument name 1`: `argument value 1`, `argument name 2`: `argument value 2`） + +可以在 函數調用表達式的尾部（最後一個參數之後）加上 一個閉包（closure） ， 該閉包會被目標函數理解並執行。它具有如下兩種寫法： + +```swift +// someFunction takes an integer and a closure as its arguments +someFunction（x, {$0 == 13}） +someFunction（x） {$0 == 13} +``` + +如果閉包是該函數的唯一參數，那麼圓括號可以省略。 + +```swift +// someFunction takes a closure as its only argument +myData.someMethod（） {$0 == 13} +myData.someMethod {$0 == 13} +``` + +> 函數調用表達式語法 +> *函數調用表達式* → [*後置表達式*](..\chapter3\04_Expressions.html#postfix_expression) [*圓括號表達式*](..\chapter3\04_Expressions.html#parenthesized_expression) +> *函數調用表達式* → [*後置表達式*](..\chapter3\04_Expressions.html#postfix_expression) [*圓括號表達式*](..\chapter3\04_Expressions.html#parenthesized_expression) _可選_ [*後置閉包(Trailing Closure)*](..\chapter3\04_Expressions.html#trailing_closure) +> *後置閉包(Trailing Closure)* → [*閉包表達式*](..\chapter3\04_Expressions.html#closure_expression) + +### 初始化函數表達式（Initializer Expression） + +Initializer表達式用來給某個Type初始化。 它的形式如下： + +> `expression`.init（`initializer arguments`） + +（Initializer表達式用來給某個Type初始化。） 跟函數（function）不同， initializer 不能返回值。 + +```swift +var x = SomeClass.someClassFunction // ok +var y = SomeClass.init // error +``` + +可以通過 initializer 表達式來委託調用（delegate to ）到superclass的initializers. + +```swift +class SomeSubClass: SomeSuperClass { + init（） { + // subclass initialization goes here + super.init（） + } +} +``` + +> 構造器表達式語法 +> *構造器表達式* → [*後置表達式*](..\chapter3\04_Expressions.html#postfix_expression) **.** **init** + +### 顯式成員表達式（Explicit Member Expression） + +顯示成員表達式允許我們訪問type, tuple, module的成員變量。它的形式如下： + +> `expression`.`member name` + +該member 就是某個type在聲明時候所定義（declaration or extension） 的變量, 例如： + +```swift +class SomeClass { + var someProperty = 42 +} +let c = SomeClass（） +let y = c.someProperty // Member access +``` + +對於tuple, 要根據它們出現的順序（0, 1, 2...）來使用: + +```swift +var t = （10, 20, 30） +t.0 = t.1 +// Now t is （20, 20, 30） +``` + +The members of a module access the top-level declarations of that module. +（不確定：對於某個module的member的調用，只能調用在top-level聲明中的member.） + +> 顯式成員表達式語法 +> *顯示成員表達式* → [*後置表達式*](..\chapter3\04_Expressions.html#postfix_expression) **.** [*十進制數字*](..\chapter3\02_Lexical_Structure.html#decimal_digit) +> *顯示成員表達式* → [*後置表達式*](..\chapter3\04_Expressions.html#postfix_expression) **.** [*標識符*](..\chapter3\02_Lexical_Structure.html#identifier) [*泛型參數子句*](GenericParametersAndArguments.html#generic_argument_clause) _可選_ + +### 後綴self表達式（Postfix Self Expression） + +後綴表達式由 某個表達式 + '.self' 組成. 形式如下： + +> `expression`.self +> `type`.self + +形式1 表示會返回 expression 的值。例如： x.self 返回 x + +形式2：返回對應的type。我們可以用它來動態的獲取某個instance的type。 + +> 後置Self 表達式語法 +> *後置self表達式* → [*後置表達式*](..\chapter3\04_Expressions.html#postfix_expression) **.** **self** + +### dynamic表達式（Dynamic Type Expression） + +（因為dynamicType是一個獨有的方法，所以這裡保留了英文單詞，未作翻譯, --- 類似與self expression） + +dynamicType 表達式由 某個表達式 + '.dynamicType' 組成。 + +> `expression`.dynamicType + +上面的形式中， expression 不能是某type的名字（當然了，如果我都知道它的名字了還需要動態來獲取它嗎）。動態類型表達式會返回"運行時"某個instance的type, 具體請看下面的列子： + +```swift +class SomeBaseClass { + class func printClassName（） { + println（"SomeBaseClass"） + } +} +class SomeSubClass: SomeBaseClass { + override class func printClassName（） { + println（"SomeSubClass"） + } +} +let someInstance: SomeBaseClass = SomeSubClass（） + +// someInstance is of type SomeBaseClass at compile time, but +// someInstance is of type SomeSubClass at runtime +someInstance.dynamicType.printClassName（） +// prints "SomeSubClass" +``` + +> 動態類型表達式語法 +> *動態類型表達式* → [*後置表達式*](..\chapter3\04_Expressions.html#postfix_expression) **.** **dynamicType** + +### 下標腳本表達式（Subscript Expression） + +下標腳本表達式提供了通過下標腳本訪問getter/setter 的方法。它的形式是： + +> `expression`[`index expressions`] + +可以通過下標腳本表達式通過getter獲取某個值，或者通過setter賦予某個值. + +關於subscript的聲明，請參見： Protocol Subscript Declaration. + +> 附屬腳本表達式語法 +> *附屬腳本表達式* → [*後置表達式*](..\chapter3\04_Expressions.html#postfix_expression) **[** [*表達式列表*](..\chapter3\04_Expressions.html#expression_list) **]** + +### 強制取值表達式（Forced-Value Expression） + +強制取值表達式用來獲取某個目標表達式的值（該目標表達式的值必須不是nil ）。它的形式如下： + +> `expression`! + +如果該表達式的值不是nil, 則返回對應的值。 否則，拋出運行時錯誤（runtime error）。 + +> 強制取值(Forced Value)語法 +> *強制取值(Forced Value)表達式* → [*後置表達式*](..\chapter3\04_Expressions.html#postfix_expression) **!** + +### 可選鏈表達式（Optional-Chaining Expression） + +可選鏈表達式由目標表達式 + '?' 組成，形式如下： + +> `expression`? + +後綴'?' 返回目標表達式的值，把它做為可選的參數傳遞給後續的表達式 + +如果某個後綴表達式包含了可選鏈表達式，那麼它的執行過程就比較特殊： 首先先判斷該可選鏈表達式的值，如果是 nil, 整個後綴表達式都返回 nil, 如果該可選鏈的值不是nil, 則正常返回該後綴表達式的值（依次執行它的各個子表達式）。在這兩種情況下，該後綴表達式仍然是一個optional type（In either case, the value of the postfix expression is still of an optional type） + +如果某個"後綴表達式"的"子表達式"中包含了"可選鏈表達式"，那麼只有最外層的表達式返回的才是一個optional type. 例如，在下面的例子中， 如果c 不是nil, 那麼 c?.property.performAction（） 這句代碼在執行時，就會先獲得c 的property方法，然後調用 performAction（）方法。 然後對於 "c?.property.performAction（）" 這個整體，它的返回值是一個optional type. + +```swift +var c: SomeClass? +var result: Bool? = c?.property.performAction（） +``` + +如果不使用可選鏈表達式，那麼 上面例子的代碼跟下面例子等價： + +```swift +if let unwrappedC = c { + result = unwrappedC.property.performAction（） +} +``` + +> 可選鏈表達式語法 +> *可選鏈表達式* → [*後置表達式*](..\chapter3\04_Expressions.html#postfix_expression) **?** diff --git a/source-tw/chapter3/05_Declarations.md b/source-tw/chapter3/05_Declarations.md new file mode 100644 index 00000000..c1ec0799 --- /dev/null +++ b/source-tw/chapter3/05_Declarations.md @@ -0,0 +1,855 @@ +> 翻譯：[marsprince](https://github.com/marsprince) +> 校對：[numbbbbb](https://github.com/numbbbbb), [stanzhai](https://github.com/stanzhai) + +# 聲明 +----------------- + +本頁包含內容： + +- [模塊範圍](#module_scope) +- [代碼塊](#code_blocks) +- [引入聲明](#import_declaration) +- [常量聲明](#constant_declaration) +- [變量聲明](#variable_declaration) +- [類型的別名聲明](#type_alias_declaration) +- [函數聲明](#function_declaration) +- [枚舉聲明](#enumeration_declaration) +- [結構體聲明](#structure_declaration) +- [類聲明](#class_declaration) +- [協議聲明](#protocol_declaration) +- [構造器聲明](#initializer_declaration) +- [析構聲明](#deinitializer_declaration) +- [擴展聲明](#extension_declaration) +- [下標腳本聲明](#subscript_declaration) +- [運算符聲明](#operator_declaration) + +一條聲明可以在你的程序裡引入新的名字和構造。舉例來說，你可以使用聲明來引入函數和方法，變量和常量，或者來定義 +新的命名好的枚舉，結構，類和協議類型。你也可以使用一條聲明來延長一個已經存在的命名好的類型的行為。或者在你的 +程序裡引入在其他地方聲明的符號。 + +在swift中，大多數聲明在某種意義上講也是執行或同事聲明它們的初始化定義。這意味著，因為協議和它們的成員不匹配， +大多數協議成員需要單獨的聲明。為了方便起見，也因為這些區別在swift裡不是很重要，聲明語句同時包含了聲明和定義。 + +> 聲明語法 +> *聲明* → [*導入聲明*](..\chapter3\05_Declarations.html#import_declaration) +> *聲明* → [*常量聲明*](..\chapter3\05_Declarations.html#constant_declaration) +> *聲明* → [*變量聲明*](..\chapter3\05_Declarations.html#variable_declaration) +> *聲明* → [*類型別名聲明*](..\chapter3\05_Declarations.html#typealias_declaration) +> *聲明* → [*函數聲明*](..\chapter3\05_Declarations.html#function_declaration) +> *聲明* → [*枚舉聲明*](..\chapter3\05_Declarations.html#enum_declaration) +> *聲明* → [*結構體聲明*](..\chapter3\05_Declarations.html#struct_declaration) +> *聲明* → [*類聲明*](..\chapter3\05_Declarations.html#class_declaration) +> *聲明* → [*協議聲明*](..\chapter3\05_Declarations.html#protocol_declaration) +> *聲明* → [*構造器聲明*](..\chapter3\05_Declarations.html#initializer_declaration) +> *聲明* → [*析構器聲明*](..\chapter3\05_Declarations.html#deinitializer_declaration) +> *聲明* → [*擴展聲明*](..\chapter3\05_Declarations.html#extension_declaration) +> *聲明* → [*附屬腳本聲明*](..\chapter3\05_Declarations.html#subscript_declaration) +> *聲明* → [*運算符聲明*](..\chapter3\05_Declarations.html#operator_declaration) +> *聲明(Declarations)列表* → [*聲明*](..\chapter3\05_Declarations.html#declaration) [*聲明(Declarations)列表*](..\chapter3\05_Declarations.html#declarations) _可選_ +> *聲明描述符(Specifiers)列表* → [*聲明描述符(Specifier)*](..\chapter3\05_Declarations.html#declaration_specifier) [*聲明描述符(Specifiers)列表*](..\chapter3\05_Declarations.html#declaration_specifiers) _可選_ +> *聲明描述符(Specifier)* → **class** | **mutating** | **nonmutating** | **override** | **static** | **unowned** | **unowned(safe)** | **unowned(unsafe)** | **weak** + + +##模塊範圍 + +模塊範圍定義了對模塊中其他源文件可見的代碼。（註：待改進）在swift的源文件中，最高級別的代碼由零個或多個語句， +聲明和表達組成。變量，常量和其他的聲明語句在一個源文件的最頂級被聲明，使得它們對同一模塊中的每個源文件都是可見的。 + +> 頂級(Top Level) 聲明語法 +> *頂級聲明* → [*多條語句(Statements)*](..\chapter3\10_Statements.html#statements) _可選_ + + +##代碼塊 + +代碼塊用來將一些聲明和控制結構的語句組織在一起。它有如下的形式： + +> { +> `statements` +> } + +代碼塊中的語句包括聲明，表達式和各種其他類型的語句，它們按照在源碼中的出現順序被依次執行。 + +> 代碼塊語法 +> *代碼塊* → **{** [*多條語句(Statements)*](..\chapter3\10_Statements.html#statements) _可選_ **}** + + +##引入聲明 + +引入聲明使你可以使用在其他文件中聲明的內容。引入語句的基本形式是引入整個代碼模塊；它由import關鍵字開始，後面 +緊跟一個模塊名： + +> import `module` + +你可以提供更多的細節來限制引入的符號，如聲明一個特殊的子模塊或者在一個模塊或子模塊中做特殊的聲明。（待改進） +當你使用了這些細節後，在當前的程序匯總只有引入的符號是可用的（並不是聲明的整個模塊）。 + +> import `import kind` `module`.`symbol name` +> import `module`.`submodule` + +

+ +> 導入(Import)聲明語法 +> *導入聲明* → [*特性(Attributes)列表*](..\chapter3\06_Attributes.html#attributes) _可選_ **import** [*導入類型*](..\chapter3\05_Declarations.html#import_kind) _可選_ [*導入路徑*](..\chapter3\05_Declarations.html#import_path) +> *導入類型* → **typealias** | **struct** | **class** | **enum** | **protocol** | **var** | **func** +> *導入路徑* → [*導入路徑標識符*](..\chapter3\05_Declarations.html#import_path_identifier) | [*導入路徑標識符*](..\chapter3\05_Declarations.html#import_path_identifier) **.** [*導入路徑*](..\chapter3\05_Declarations.html#import_path) +> *導入路徑標識符* → [*標識符*](LexicalStructure.html#identifier) | [*運算符*](LexicalStructure.html#operator) + + +##常量聲明 + +常量聲明可以在你的程序裡命名一個常量。常量以關鍵詞let來聲明，遵循如下的格式: + +> let `constant name`: `type` = `expression` + +當常量的值被給定後，常量就將常量名稱和表達式初始值不變的結合在了一起，而且不能更改。 +這意味著如果常量以類的形式被初始化，類本身的內容是可以改變的，但是常量和類之間的結合關係是不能改變的。 +當一個常量被聲明為全局變量，它必須被給定一個初始值。當一個常量在類或者結構體中被聲明時，它被認為是一個常量 +屬性。常量並不是可計算的屬性，因此不包含getters和setters。（譯者註：getters和setters不知道怎麼翻譯，待改進） + +如果常量名是一個元祖形式，元祖中的每一項初始化表達式中都要有對應的值 + +```swift +let (firstNumber, secondNumber) = (10, 42) +``` + +在上例中，firstNumber是一個值為10的常量，secnodeName是一個值為42的常量。所有常量都可以獨立的使用： + +```swift +println("The first number is \(firstNumber).") +// prints "The first number is 10." +println("The second number is \(secondNumber).") +// prints "The second number is 42." +``` + +類型註釋（:type）在常量聲明中是一個可選項，它可以用來描述在類型推斷（type inference）中找到的類型。 + +聲明一個靜態常量要使用關鍵字static。靜態屬性在類型屬性（type propetries）中有介紹。 + +如果還想獲得更多關於常量的信息或者想在使用中獲得幫助，請查看常量和變量（constants and variables）, +存儲屬性（stored properties）等節。 + +> 常數聲明語法 +> *常量聲明* → [*特性(Attributes)列表*](..\chapter3\06_Attributes.html#attributes) _可選_ [*聲明描述符(Specifiers)列表*](..\chapter3\05_Declarations.html#declaration_specifiers) _可選_ **let** [*模式構造器列表*](..\chapter3\05_Declarations.html#pattern_initializer_list) +> *模式構造器列表* → [*模式構造器*](..\chapter3\05_Declarations.html#pattern_initializer) | [*模式構造器*](..\chapter3\05_Declarations.html#pattern_initializer) **,** [*模式構造器列表*](..\chapter3\05_Declarations.html#pattern_initializer_list) +> *模式構造器* → [*模式*](..\chapter3\07_Patterns.html#pattern) [*構造器*](..\chapter3\05_Declarations.html#initializer) _可選_ +> *構造器* → **=** [*表達式*](..\chapter3\04_Expressions.html#expression) + + +##變量聲明 + +變量聲明可以在你的程序裡聲明一個變量，它以關鍵字var來聲明。根據聲明變量類型和值的不同，如存儲和計算 +變量和屬性，存儲變量和屬性監視，和靜態變量屬性，有著不同的聲明形式。（待改進） +所使用的聲明形式取決於變量所聲明的範圍和你打算聲明的變量類型。 + +>注意： +你也可以在協議聲明的上下文聲明屬性，詳情參見類型屬性聲明。 + +###存儲型變量和存儲型屬性 + +下面的形式聲明了一個存儲型變量或存儲型變量屬性 + +> var `variable name`: `type` = `expression` + +你可以在全局，函數內，或者在類和結構體的聲明(context)中使用這種形式來聲明一個變量。當變量以這種形式 +在全局或者一個函數內被聲明時，它代表一個存儲型變量。當它在類或者結構體中被聲明時，它代表一個存儲型變量屬性。 + +初始化的表達式不可以在協議（protocol）的定義中出現，在其他情況下，初始化表達式是可選的（optional），如果沒有初始化表達式，那麼變量定義時必須顯示的聲明變量類型（:type) + +對於常量的定義，如果名字是一個元祖（tuple），元祖每一項的`name`都要和初始化表達式`expression`中的相應值一致。 + +正如名字一樣，存儲型變量的值或存儲型變量屬性存儲在內存中。 + +###計算型變量和計算型屬性 + +如下形式聲明一個一個存儲型變量或存儲型屬性： + +> var `variable name`: `type` { +> get { +> `statements` +> } +> set(`setter name`) { +> `statements` +> } +> } + +你可以在全局，函數體內或者類，結構體，枚舉，擴展聲明的上下文中使用這種形式的聲明。 +當變量以這種形式在全局或者一個函數內被聲明時，它代表一個計算型變量。當它在類，結構體，枚舉，擴展聲明的上下文 +中中被聲明時，它代表一個計算型變量屬性。 + +getter用來讀取變量值，setter用來寫入變量值。setter子句是可選擇的，只有getter是必需的，你可以將這些語句 +都省略，只是簡單的直接返回請求值，正如在只讀計算屬性(read-only computed properites)中描述的那樣。 +但是如果你提供了一個setter語句，你也必需提供一個getter語句。 + +setter的名字和圓括號內的語句是可選的。如果你寫了一個setter名，它就會作為setter的參數被使用。如果你不寫setter名， +setter的初始名為newValue，正如在setter聲明速記(shorthand setter declaration)中提到的那樣。 + +不像存儲型變量和存儲型屬性那樣，計算型屬性和計算型變量的值不存儲在內存中。 + +獲得更多信息，查看更多關於計算型屬性的例子，請查看計算型屬性(computed properties)一節。 + +###存儲型變量監視器和屬性監視器 + +你可以用willset和didset監視器來聲明一個存儲型變量或屬性。一個包含監視器的存儲型變量或屬性按如下的形式聲明： + +> var `variable name`: `type` = expression { +> willSet(setter name) { +> `statements` +> } +> didSet(`setter name`) { +> `statements` +> } +> } + +你可以在全局，函數體內或者類，結構體，枚舉，擴展聲明的上下文中使用這種形式的聲明。 +當變量以這種形式在全局或者一個函數內被聲明時，監視器代表一個存儲型變量監視器； +當它在類，結構體，枚舉，擴展聲明的上下文中被聲明時，監視器代表屬性監視器。 + +你可以為適合的監視器添加任何存儲型屬性。你也可以通過重寫子類屬性的方式為適合的監視器添加任何繼承的屬性 +(無論是存儲型還是計算型的)，參見重寫屬性監視器(overriding properyt observers)。 + +初始化表達式在類或者結構體的聲明中是可選的，但是在其他地方是必需的。無論在什麼地方聲明， +所有包含監視器的變量聲明都必須有類型註釋(type annotation)。 + +當變量或屬性的值被改變時，willset和didset監視器提供了一個監視方法（適當的回應）。 +監視器不會在變量或屬性第一次初始化時運行，它們只有在值被外部初始化語句改變時才會被運行。 + +willset監視器只有在變量或屬性值被改變之前運行。新的值作為一個常量經過過willset監視器，因此不可以在 +willset語句中改變它。didset監視器在變量或屬性值被改變後立即運行。和willset監視器相反，為了以防止你仍然 +需要獲得舊的數據，舊變量值或者屬性會經過didset監視器。這意味著，如果你在變量或屬性自身的didiset監視器語句 +中設置了一個值，你設置的新值會取代剛剛在willset監視器中經過的那個值。 + +在willset和didset語句中，setter名和圓括號的語句是可選的。如果你寫了一個setter名，它就會作為willset和didset的參數被使用。如果你不寫setter名， +willset監視器初始名為newvalue，didset監視器初始名為oldvalue。 + +當你提供一個willset語句時，didset語句是可選的。同樣的，在你提供了一個didset語句時，willset語句是可選的。 + +獲得更多信息，查看如何使用屬性監視器的例子，請查看屬性監視器(prpperty observers)一節。 + +###類和靜態變量屬性 + +class關鍵字用來聲明類的計算型屬性。static關鍵字用來聲明類的靜態變量屬性。類和靜態變量在類型屬性(type properties)中有詳細討論。 + +> 變量聲明語法 +> *變量聲明* → [*變量聲明頭(Head)*](..\chapter3\05_Declarations.html#variable_declaration_head) [*模式構造器列表*](..\chapter3\05_Declarations.html#pattern_initializer_list) +> *變量聲明* → [*變量聲明頭(Head)*](..\chapter3\05_Declarations.html#variable_declaration_head) [*變量名*](..\chapter3\05_Declarations.html#variable_name) [*類型註解*](..\chapter3\03_Types.html#type_annotation) [*代碼塊*](..\chapter3\05_Declarations.html#code_block) +> *變量聲明* → [*變量聲明頭(Head)*](..\chapter3\05_Declarations.html#variable_declaration_head) [*變量名*](..\chapter3\05_Declarations.html#variable_name) [*類型註解*](..\chapter3\03_Types.html#type_annotation) [*getter-setter塊*](..\chapter3\05_Declarations.html#getter_setter_block) +> *變量聲明* → [*變量聲明頭(Head)*](..\chapter3\05_Declarations.html#variable_declaration_head) [*變量名*](..\chapter3\05_Declarations.html#variable_name) [*類型註解*](..\chapter3\03_Types.html#type_annotation) [*getter-setter關鍵字(Keyword)塊*](..\chapter3\05_Declarations.html#getter_setter_keyword_block) +> *變量聲明* → [*變量聲明頭(Head)*](..\chapter3\05_Declarations.html#variable_declaration_head) [*變量名*](..\chapter3\05_Declarations.html#variable_name) [*類型註解*](..\chapter3\03_Types.html#type_annotation) [*構造器*](..\chapter3\05_Declarations.html#initializer) _可選_ [*willSet-didSet代碼塊*](..\chapter3\05_Declarations.html#willSet_didSet_block) +> *變量聲明頭(Head)* → [*特性(Attributes)列表*](..\chapter3\06_Attributes.html#attributes) _可選_ [*聲明描述符(Specifiers)列表*](..\chapter3\05_Declarations.html#declaration_specifiers) _可選_ **var** +> *變量名稱* → [*標識符*](LexicalStructure.html#identifier) +> *getter-setter塊* → **{** [*getter子句*](..\chapter3\05_Declarations.html#getter_clause) [*setter子句*](..\chapter3\05_Declarations.html#setter_clause) _可選_ **}** +> *getter-setter塊* → **{** [*setter子句*](..\chapter3\05_Declarations.html#setter_clause) [*getter子句*](..\chapter3\05_Declarations.html#getter_clause) **}** +> *getter子句* → [*特性(Attributes)列表*](..\chapter3\06_Attributes.html#attributes) _可選_ **get** [*代碼塊*](..\chapter3\05_Declarations.html#code_block) +> *setter子句* → [*特性(Attributes)列表*](..\chapter3\06_Attributes.html#attributes) _可選_ **set** [*setter名稱*](..\chapter3\05_Declarations.html#setter_name) _可選_ [*代碼塊*](..\chapter3\05_Declarations.html#code_block) +> *setter名稱* → **(** [*標識符*](LexicalStructure.html#identifier) **)** +> *getter-setter關鍵字(Keyword)塊* → **{** [*getter關鍵字(Keyword)子句*](..\chapter3\05_Declarations.html#getter_keyword_clause) [*setter關鍵字(Keyword)子句*](..\chapter3\05_Declarations.html#setter_keyword_clause) _可選_ **}** +> *getter-setter關鍵字(Keyword)塊* → **{** [*setter關鍵字(Keyword)子句*](..\chapter3\05_Declarations.html#setter_keyword_clause) [*getter關鍵字(Keyword)子句*](..\chapter3\05_Declarations.html#getter_keyword_clause) **}** +> *getter關鍵字(Keyword)子句* → [*特性(Attributes)列表*](..\chapter3\06_Attributes.html#attributes) _可選_ **get** +> *setter關鍵字(Keyword)子句* → [*特性(Attributes)列表*](..\chapter3\06_Attributes.html#attributes) _可選_ **set** +> *willSet-didSet代碼塊* → **{** [*willSet子句*](..\chapter3\05_Declarations.html#willSet_clause) [*didSet子句*](..\chapter3\05_Declarations.html#didSet_clause) _可選_ **}** +> *willSet-didSet代碼塊* → **{** [*didSet子句*](..\chapter3\05_Declarations.html#didSet_clause) [*willSet子句*](..\chapter3\05_Declarations.html#willSet_clause) **}** +> *willSet子句* → [*特性(Attributes)列表*](..\chapter3\06_Attributes.html#attributes) _可選_ **willSet** [*setter名稱*](..\chapter3\05_Declarations.html#setter_name) _可選_ [*代碼塊*](..\chapter3\05_Declarations.html#code_block) +> *didSet子句* → [*特性(Attributes)列表*](..\chapter3\06_Attributes.html#attributes) _可選_ **didSet** [*setter名稱*](..\chapter3\05_Declarations.html#setter_name) _可選_ [*代碼塊*](..\chapter3\05_Declarations.html#code_block) + + +##類型的別名聲明 + +類型別名的聲明可以在你的程序裡為一個已存在的類型聲明一個別名。類型的別名聲明以關鍵字typealias開始，遵循如下的 +形式： + +> `typealias name` = `existing type` + +當聲明一個類型的別名後，你可以在你程序的任何地方使用別名來代替已存在的類型。已存在的類型可以是已經被命名的 +類型或者是混合類型。類型的別名不產生新的類型，它只是簡單的和已存在的類型做名稱替換。 + +查看更多Protocol Associated Type Declaration. + +> 類型別名聲明語法 +> *類型別名聲明* → [*類型別名頭(Head)*](..\chapter3\05_Declarations.html#typealias_head) [*類型別名賦值*](..\chapter3\05_Declarations.html#typealias_assignment) +> *類型別名頭(Head)* → **typealias** [*類型別名名稱*](..\chapter3\05_Declarations.html#typealias_name) +> *類型別名名稱* → [*標識符*](LexicalStructure.html#identifier) +> *類型別名賦值* → **=** [*類型*](..\chapter3\03_Types.html#type) + + +##函數聲明 + +你可以使用函數聲明在你的程序裡引入新的函數。函數可以在類的上下文，結構體，枚舉，或者作為方法的協議中被聲明。 +函數聲明使用關鍵字func，遵循如下的形式： + +> func `function name`(`parameters`) -> `return type` { +> `statements` +> } + +如果函數不返回任何值，返回類型可以被忽略，如下所示： + +> func `function name`(`parameters`) { +> `statements` +> } + +每個參數的類型都要標明，它們不能被推斷出來。初始時函數的參數是常量。在這些參數前面添加var使它們成為變量， +作用域內任何對變量的改變只在函數體內有效，或者用inout使的這些改變可以在調用域內生效。 +更多關於in-out參數的討論，參見in-out參數(in-out parameters) + +函數可以使用元組類型作為返回值來返回多個變量。 + +函數定義可以出現在另一個函數聲明內。這種函數被稱作nested函數。更多關於nested函數的討論，參見nestde functions。 + +###參數名 + +函數的參數是一個以逗號分隔的列表 。函數調用是的變量順序必須和函數聲明時的參數順序一致。 +最簡單的參數列表有著如下的形式： + +> `parameter name`: `parameter type` + +對於函數參數來講，參數名在函數體內被使用，而不是在函數調用時使用。對於方法參數，參數名在函數體內被使用， +同時也在方法被調用時作為標籤被使用。該方法的第一個參數名僅僅在函數體內被使用，就像函數的參數一樣，舉例來講： + +```swift +func f(x: Int, y: String) -> String { + return y + String(x) +} +f(7, "hello") // x and y have no name +``` + +```swift +class C { + func f(x: Int, y: String) -> String { + return y + String(x) + } +} +let c = C() +c.f(7, y: "hello") // x沒有名稱，y有名稱 +``` + +你可以按如下的形式，重寫參數名被使用的過程： + +> `external parameter name` `local parameter name`: `parameter type` +> #`parameter name`: `parameter type` +> _ `local parameter name`: `parameter type` + +在本地參數前命名的第二名稱(second name)使得參數有一個擴展名。且不同於本地的參數名。 +擴展參數名在函數被調用時必須被使用。對應的參數在方法或函數被調用時必須有擴展名 。 + +在參數名前所寫的哈希符號(#)代表著這個參數名可以同時作為外部或本體參數名來使用。等同於書寫兩次本地參數名。 +在函數或方法調用時，與其對應的語句必須包含這個名字。 + +本地參數名前的強調字符(_)使參數在函數被調用時沒有名稱。在函數或方法調用時，與其對應的語句必須沒有名字。 + +###特殊類型的參數 + +參數可以被忽略，值可以是變化的，並且提供一個初始值，這種方法有著如下的形式： + +> _ : <#parameter type#. +> `parameter name`: `parameter type`... +> `parameter name`: `parameter type` = `default argument value` + +以強調符(_)命名的參數明確的在函數體內不能被訪問。 + +一個以基礎類型名的參數，如果緊跟著三個點(...)，被理解為是可變參數。一個函數至多可以擁有一個可變參數， +且必須是最後一個參數。可變參數被作為該基本類型名的數組來看待。舉例來講，可變參數int...被看做是int[]。 +查看可變參數的使用例子，詳見可變參數(variadic parameters)一節。 + +在參數的類型後面有一個以等號(=)連接的表達式，這樣的參數被看做有著給定表達式的初始值。如果參數在函數 +調用時被省略了，就會使用初始值。如果參數沒有省略，那麼它在函數調用是必須有自己的名字.舉例來講， +f()和f(x:7)都是只有一個變量x的函數的有效調用，但是f(7)是非法的，因為它提供了一個值而不是名稱。 + +###特殊方法 + +以self修飾的枚舉或結構體方法必須以mutating關鍵字作為函數聲明頭。 + +子類重寫的方法必須以override關鍵字作為函數聲明頭。不用override關鍵字重寫的方法，使用了override關鍵字 +卻並沒有重寫父類方法都會報錯。 + +和類型相關而不是和類型實例相關的方法必須在static聲明的結構以或枚舉內，亦或是以class關鍵字定義的類內。 + +###柯裡化函數和方法(Curried Functions and Methods) + +柯裡化函數或方法有著如下的形式： + +> func `function name`(`parameters`)(`parameters`) -> `return type` { +> `statements` +> } + +以這種形式定義的函數的返回值是另一個函數。舉例來說，下面的兩個聲明是等價的: + +```swift +func addTwoNumbers(a: Int)(b: Int) -> Int { + return a + b +} +func addTwoNumbers(a: Int) -> (Int -> Int) { + func addTheSecondNumber(b: Int) -> Int { + return a + b + } + return addTheSecondNumber +} +``` + +```swift +addTwoNumbers(4)(5) // Returns 9 +``` + +多級柯裡化應用如下 + +> 函數聲明語法 +> *函數聲明* → [*函數頭*](..\chapter3\05_Declarations.html#function_head) [*函數名*](..\chapter3\05_Declarations.html#function_name) [*泛型參數子句*](GenericParametersAndArguments.html#generic_parameter_clause) _可選_ [*函數簽名(Signature)*](..\chapter3\05_Declarations.html#function_signature) [*函數體*](..\chapter3\05_Declarations.html#function_body) +> *函數頭* → [*特性(Attributes)列表*](..\chapter3\06_Attributes.html#attributes) _可選_ [*聲明描述符(Specifiers)列表*](..\chapter3\05_Declarations.html#declaration_specifiers) _可選_ **func** +> *函數名* → [*標識符*](LexicalStructure.html#identifier) | [*運算符*](LexicalStructure.html#operator) +> *函數簽名(Signature)* → [*parameter-clauses*](..\chapter3\05_Declarations.html#parameter_clauses) [*函數結果*](..\chapter3\05_Declarations.html#function_result) _可選_ +> *函數結果* → **->** [*特性(Attributes)列表*](..\chapter3\06_Attributes.html#attributes) _可選_ [*類型*](..\chapter3\03_Types.html#type) +> *函數體* → [*代碼塊*](..\chapter3\05_Declarations.html#code_block) +> *parameter-clauses* → [*參數子句*](..\chapter3\05_Declarations.html#parameter_clause) [*parameter-clauses*](..\chapter3\05_Declarations.html#parameter_clauses) _可選_ +> *參數子句* → **(** **)** | **(** [*參數列表*](..\chapter3\05_Declarations.html#parameter_list) **...** _可選_ **)** +> *參數列表* → [*參數*](..\chapter3\05_Declarations.html#parameter) | [*參數*](..\chapter3\05_Declarations.html#parameter) **,** [*參數列表*](..\chapter3\05_Declarations.html#parameter_list) +> *參數* → **inout** _可選_ **let** _可選_ **#** _可選_ [*參數名*](..\chapter3\05_Declarations.html#parameter_name) [*本地參數名*](..\chapter3\05_Declarations.html#local_parameter_name) _可選_ [*類型註解*](..\chapter3\03_Types.html#type_annotation) [*默認參數子句*](..\chapter3\05_Declarations.html#default_argument_clause) _可選_ +> *參數* → **inout** _可選_ **var** **#** _可選_ [*參數名*](..\chapter3\05_Declarations.html#parameter_name) [*本地參數名*](..\chapter3\05_Declarations.html#local_parameter_name) _可選_ [*類型註解*](..\chapter3\03_Types.html#type_annotation) [*默認參數子句*](..\chapter3\05_Declarations.html#default_argument_clause) _可選_ +> *參數* → [*特性(Attributes)列表*](..\chapter3\06_Attributes.html#attributes) _可選_ [*類型*](..\chapter3\03_Types.html#type) +> *參數名* → [*標識符*](LexicalStructure.html#identifier) | **_** +> *本地參數名* → [*標識符*](LexicalStructure.html#identifier) | **_** +> *默認參數子句* → **=** [*表達式*](..\chapter3\04_Expressions.html#expression) + + +##枚舉聲明 + +在你的程序裡使用枚舉聲明來引入一個枚舉類型。 + +枚舉聲明有兩種基本的形式，使用關鍵字enum來聲明。枚舉聲明體使用從零開始的變量——叫做枚舉事件，和任意數量的 +聲明，包括計算型屬性，實例方法，靜態方法，構造器，類型別名，甚至其他枚舉，結構體，和類。枚舉聲明不能 +包含析構器或者協議聲明。 + +不像類或者結構體。枚舉類型並不提供隱式的初始構造器，所有構造器必須顯式的聲明。構造器可以委託枚舉中的其他 +構造器，但是構造過程僅當構造器將一個枚舉時間完成後才全部完成。 + +和結構體類似但是和類不同，枚舉是值類型：枚舉實例在賦予變量或常量時，或者被函數調用時被複製。 +更多關於值類型的信息，參見結構體和枚舉都是值類型(Structures and Enumerations Are Value Types)一節。 + +你可以擴展枚舉類型，正如在擴展名聲明(Extension Declaration)中討論的一樣。 + +###任意事件類型的枚舉 + +如下的形式聲明了一個包含任意類型枚舉時間的枚舉變量 + +> enum `enumeration name` { +> case `enumeration case 1` +> case `enumeration case 2`(`associated value types`) +> } + +這種形式的枚舉聲明在其他語言中有時被叫做可識別聯合(discrinminated)。 + +這種形式中，每一個事件塊由關鍵字case開始，後面緊接著一個或多個以逗號分隔的枚舉事件。每一個事件名必須是 +獨一無二的。每一個事件也可以指定它所存儲的指定類型的值，這些類型在關聯值類型的元祖裡被指定，立即書寫在事件 +名後。獲得更多關於關聯值類型的信息和例子，請查看關聯值(associated values)一節。 + +###使用原始事件值的枚舉 + +以下的形式聲明了一個包含相同基礎類型的枚舉事件的枚舉： + +> enum `enumeration name`: `raw value type` { +> case `enumeration case 1` = `raw value 1` +> case `enumeration case 2` = `raw value 2` +> } + +在這種形式中，每一個事件塊由case關鍵字開始，後面緊接著一個或多個以逗號分隔的枚舉事件。和第一種形式的枚舉 +事件不同，這種形式的枚舉事件包含一個同類型的基礎值，叫做原始值(raw value)。這些值的類型在原始值類型(raw value type) +中被指定，必須是字面上的整數，浮點數，字符或者字符串。 + +每一個事件必須有唯一的名字，必須有一個唯一的初始值。如果初始值類型被指定為int，則不必為事件顯式的指定值， +它們會隱式的被標為值0,1,2等。每一個沒有被賦值的Int類型時間會隱式的賦予一個初始值，它們是自動遞增的。 + +```swift +num ExampleEnum: Int { + case A, B, C = 5, D +} +``` + +在上面的例子中，ExampleEnum.A的值是0，ExampleEnum.B的值是。因為ExampleEnum.C的值被顯式的設定為5，因此 +ExampleEnum.D的值會自動增長為6. + +枚舉事件的初始值可以調用方法roRaw獲得，如ExampleEnum.B.toRaw()。你也可以通過調用fromRaw方法來使用初始值找到 +其對應的事件，並返回一個可選的事件。查看更多信息和獲取初始值類型事件的信息，參閱初始值(raw values)。 + +###獲得枚舉事件 + +使用點(.)來引用枚舉類型的事件，如 EnumerationType.EnumerationCase。當枚舉類型可以上下文推斷出時，你可以 +省略它(.仍然需要)，參照枚舉語法(Enumeration Syntax)和顯式成員表達(Implicit Member Expression). + +使用switch語句來檢驗枚舉事件的值，正如使用switch語句匹配枚舉值（Matching Enumeration Values with a Switch Statement)一節描述的那樣。 + +枚舉類型是模式匹配(pattern-matched)的，和其相反的是switch語句case塊中枚舉事件匹配，在枚舉事件類型(Enumeration Case Pattern)中有描述。 + +> 枚舉聲明語法 +> *枚舉聲明* → [*特性(Attributes)列表*](..\chapter3\06_Attributes.html#attributes) _可選_ [*聯合式枚舉*](..\chapter3\05_Declarations.html#union_style_enum) | [*特性(Attributes)列表*](..\chapter3\06_Attributes.html#attributes) _可選_ [*原始值式枚舉*](..\chapter3\05_Declarations.html#raw_value_style_enum) +> *聯合式枚舉* → [*枚舉名*](..\chapter3\05_Declarations.html#enum_name) [*泛型參數子句*](GenericParametersAndArguments.html#generic_parameter_clause) _可選_ **{** [*union-style-enum-members*](..\chapter3\05_Declarations.html#union_style_enum_members) _可選_ **}** +> *union-style-enum-members* → [*union-style-enum-member*](..\chapter3\05_Declarations.html#union_style_enum_member) [*union-style-enum-members*](..\chapter3\05_Declarations.html#union_style_enum_members) _可選_ +> *union-style-enum-member* → [*聲明*](..\chapter3\05_Declarations.html#declaration) | [*聯合式(Union Style)的枚舉case子句*](..\chapter3\05_Declarations.html#union_style_enum_case_clause) +> *聯合式(Union Style)的枚舉case子句* → [*特性(Attributes)列表*](..\chapter3\06_Attributes.html#attributes) _可選_ **case** [*聯合式(Union Style)的枚舉case列表*](..\chapter3\05_Declarations.html#union_style_enum_case_list) +> *聯合式(Union Style)的枚舉case列表* → [*聯合式(Union Style)的case*](..\chapter3\05_Declarations.html#union_style_enum_case) | [*聯合式(Union Style)的case*](..\chapter3\05_Declarations.html#union_style_enum_case) **,** [*聯合式(Union Style)的枚舉case列表*](..\chapter3\05_Declarations.html#union_style_enum_case_list) +> *聯合式(Union Style)的case* → [*枚舉的case名*](..\chapter3\05_Declarations.html#enum_case_name) [*元組類型*](..\chapter3\03_Types.html#tuple_type) _可選_ +> *枚舉名* → [*標識符*](LexicalStructure.html#identifier) +> *枚舉的case名* → [*標識符*](LexicalStructure.html#identifier) +> *原始值式枚舉* → [*枚舉名*](..\chapter3\05_Declarations.html#enum_name) [*泛型參數子句*](GenericParametersAndArguments.html#generic_parameter_clause) _可選_ **:** [*類型標識*](..\chapter3\03_Types.html#type_identifier) **{** [*原始值式枚舉成員列表*](..\chapter3\05_Declarations.html#raw_value_style_enum_members) _可選_ **}** +> *原始值式枚舉成員列表* → [*原始值式枚舉成員*](..\chapter3\05_Declarations.html#raw_value_style_enum_member) [*原始值式枚舉成員列表*](..\chapter3\05_Declarations.html#raw_value_style_enum_members) _可選_ +> *原始值式枚舉成員* → [*聲明*](..\chapter3\05_Declarations.html#declaration) | [*原始值式枚舉case子句*](..\chapter3\05_Declarations.html#raw_value_style_enum_case_clause) +> *原始值式枚舉case子句* → [*特性(Attributes)列表*](..\chapter3\06_Attributes.html#attributes) _可選_ **case** [*原始值式枚舉case列表*](..\chapter3\05_Declarations.html#raw_value_style_enum_case_list) +> *原始值式枚舉case列表* → [*原始值式枚舉case*](..\chapter3\05_Declarations.html#raw_value_style_enum_case) | [*原始值式枚舉case*](..\chapter3\05_Declarations.html#raw_value_style_enum_case) **,** [*原始值式枚舉case列表*](..\chapter3\05_Declarations.html#raw_value_style_enum_case_list) +> *原始值式枚舉case* → [*枚舉的case名*](..\chapter3\05_Declarations.html#enum_case_name) [*原始值賦值*](..\chapter3\05_Declarations.html#raw_value_assignment) _可選_ +> *原始值賦值* → **=** [*字面量*](LexicalStructure.html#literal) + + +##結構體聲明 + +使用結構體聲明可以在你的程序裡引入一個結構體類型。結構體聲明使用struct關鍵字，遵循如下的形式： + +> struct `structure name`: `adopted protocols` { +> `declarations` +> } + +結構體內包含零或多個聲明。這些聲明可以包括存儲型和計算型屬性，靜態屬性，實例方法，靜態方法，構造器， +類型別名，甚至其他結構體，類，和枚舉聲明。結構體聲明不能包含析構器或者協議聲明。詳細討論和包含多種結構體 +聲明的實例，參見類和結構體一節。 + +結構體可以包含任意數量的協議，但是不能繼承自類，枚舉或者其他結構體。 + +有三種方法可以創建一個聲明過的結構體實例： + +-調用結構體內聲明的構造器，參照構造器(initializers)一節。 + +—如果沒有聲明構造器，調用結構體的逐個構造器，詳情參見Memberwise Initializers for Structure Types. + +—如果沒有聲明析構器，結構體的所有屬性都有初始值，調用結構體的默認構造器，詳情參見默認構造器(Default Initializers). + +結構體的構造過程參見初始化(initiaization)一節。 + +結構體實例屬性可以用點(.)來獲得，詳情參見獲得屬性(Accessing Properties)一節。 + +結構體是值類型；結構體的實例在被賦予變量或常量，被函數調用時被複製。獲得關於值類型更多信息，參見 +結構體和枚舉都是值類型(Structures and Enumerations Are Value Types)一節。 + +你可以使用擴展聲明來擴展結構體類型的行為，參見擴展聲明(Extension Declaration). + +> 結構體聲明語法 +> *結構體聲明* → [*特性(Attributes)列表*](..\chapter3\06_Attributes.html#attributes) _可選_ **struct** [*結構體名稱*](..\chapter3\05_Declarations.html#struct_name) [*泛型參數子句*](GenericParametersAndArguments.html#generic_parameter_clause) _可選_ [*類型繼承子句*](..\chapter3\03_Types.html#type_inheritance_clause) _可選_ [*結構體主體*](..\chapter3\05_Declarations.html#struct_body) +> *結構體名稱* → [*標識符*](LexicalStructure.html#identifier) +> *結構體主體* → **{** [*聲明(Declarations)列表*](..\chapter3\05_Declarations.html#declarations) _可選_ **}** + + +##類聲明 + +你可以在你的程序中使用類聲明來引入一個類。類聲明使用關鍵字class，遵循如下的形式： + +> class `class name`: `superclass`, `adopted protocols` { +> `declarations` +> } + +一個類內包含零或多個聲明。這些聲明可以包括存儲型和計算型屬性，實例方法，類方法，構造器，單獨的析構器方法， +類型別名，甚至其他結構體，類，和枚舉聲明。類聲明不能包含協議聲明。詳細討論和包含多種類聲明的實例，參見類和 +結構體一節。 + +一個類只能繼承一個父類，超類，但是可以包含任意數量的協議。這些超類第一次在type-inheritance-clause出現，遵循任意協議。 + +正如在初始化聲明(Initializer Declaration)談及的那樣，類可以有指定(designated)和方便(convenience)構造器。當你聲明任一種構造器時， +你可以使用required變量來標記構造器，要求任意子類來重寫它。指定類的構造器必須初始化類所有的已聲明的屬性， +它必須在子類構造器調用前被執行。 + +類可以重寫屬性，方法和它的超類的構造器。重寫的方法和屬性必須以override標注。 + +雖然超類的屬性和方法聲明可以被當前類繼承，但是超類聲明的指定構造器卻不能。這意味著，如果當前類重寫了超類 +的所有指定構造器，它就繼承了超類的方便構造器。Swift的類並不是繼承自一個全局基礎類。 + +有兩種方法來創建已聲明的類的實例： + +- 調用類的一個構造器，參見構造器(initializers)。 +- 如果沒有聲明構造器，而且類的所有屬性都被賦予了初始值，調用類的默認構造器，參見默認構造器(default initializers). + +類實例屬性可以用點(.)來獲得，詳情參見獲得屬性(Accessing Properties)一節。 + +類是引用類型；當被賦予常量或變量，函數調用時，類的實例是被引用，而不是複製。獲得更多關於引用類型的信息， +結構體和枚舉都是值類型(Structures and Enumerations Are Value Types)一節。 + +你可以使用擴展聲明來擴展類的行為，參見擴展聲明(Extension Declaration). + +> 類聲明語法 +> *類聲明* → [*特性(Attributes)列表*](..\chapter3\06_Attributes.html#attributes) _可選_ **class** [*類名*](..\chapter3\05_Declarations.html#class_name) [*泛型參數子句*](GenericParametersAndArguments.html#generic_parameter_clause) _可選_ [*類型繼承子句*](..\chapter3\03_Types.html#type_inheritance_clause) _可選_ [*類主體*](..\chapter3\05_Declarations.html#class_body) +> *類名* → [*標識符*](LexicalStructure.html#identifier) +> *類主體* → **{** [*聲明(Declarations)列表*](..\chapter3\05_Declarations.html#declarations) _可選_ **}** + + +##協議聲明(translated by 小一) + +一個協議聲明為你的程序引入一個命名了的協議類型。協議聲明使用 `protocol` 關鍵詞來進行聲明並有下面這樣的形式： + +> protocol `protocol name`: `inherited protocols` { +> `protocol member declarations` +> } + +協議的主體包含零或多個協議成員聲明，這些成員描述了任何採用該協議必須滿足的一致性要求。特別的，一個協議可以聲明必須實現某些屬性、方法、初始化程序及下標腳本的一致性類型。協議也可以聲明專用種類的類型別名，叫做關聯類型，它可以指定協議的不同聲明之間的關係。協議成員聲明會在下面的詳情裡進行討論。 + +協議類型可以從很多其它協議那繼承。當一個協議類型從其它協議那繼承的時候，來自其它協議的所有要求就集合了，而且從當前協議繼承的任何類型必須符合所有的這些要求。對於如何使用協議繼承的例子，查看[協議繼承](../chapter2/21_Protocols.html#protocol_inheritance) + +> 注意： +你也可以使用協議合成類型集合多個協議的一致性要求，詳情參見[協議合成類型](../chapter3/03_Types.html#protocol_composition_type)和[協議合成](../chapter2/21_Protocols.html#protocol_composition) + +你可以通過採用在類型的擴展聲明中的協議來為之前聲明的類型添加協議一致性。在擴展中你必須實現所有採用協議的要求。如果該類型已經實現了所有的要求，你可以讓這個擴展聲明的主題留空。 + +默認地，符合某一個協議的類型必須實現所有聲明在協議中的屬性、方法和下標腳本。也就是說，你可以用`optional`屬性標注這些協議成員聲明以指定它們的一致性類型實現是可選的。`optional`屬性僅僅可以用於使用`objc`屬性標記過的協議。這樣的結果就是僅僅類類型可以採用並符合包含可選成員要求的協議。更多關於如何使用`optional`屬性的信息及如何訪問可選協議成員的指導——比如當你不能肯定是否一致性的類型實現了它們——參見[可選協議要求](../chapter2/21_Protocols.html#optional_protocol_requirements) + +為了限制協議的採用僅僅針對類類型，需要使用`class_protocol`屬性標記整個協議聲明。任意繼承自標記有`class_protocol`屬性協議的協議都可以智能地僅能被類類型採用。 + +>注意： +如果協議已經用`object`屬性標記了，`class_protocol`屬性就隱性地應用於該協議；沒有必要再明確地使用`class_protocol`屬性來標記該協議了。 + +協議是命名的類型，因此它們可以以另一個命名類型出現在你代碼的所有地方，就像[協議類型](../chapter2/21_Protocols.html#protocols_as_types)裡討論的那樣。然而你不能構造一個協議的實例，因為協議實際上不提供它們指定的要求的實現。 + +你可以使用協議來聲明一個類的代理的方法或者應該實現的結構，就像[委託(代理)模式](../chapter2/21_Protocols.html#delegation)描述的那樣。 + +> 協議(Protocol)聲明語法 +> *協議聲明* → [*特性(Attributes)列表*](..\chapter3\06_Attributes.html#attributes) _可選_ **protocol** [*協議名*](..\chapter3\05_Declarations.html#protocol_name) [*類型繼承子句*](..\chapter3\03_Types.html#type_inheritance_clause) _可選_ [*協議主體*](..\chapter3\05_Declarations.html#protocol_body) +> *協議名* → [*標識符*](LexicalStructure.html#identifier) +> *協議主體* → **{** [*協議成員聲明(Declarations)列表*](..\chapter3\05_Declarations.html#protocol_member_declarations) _可選_ **}** +> *協議成員聲明* → [*協議屬性聲明*](..\chapter3\05_Declarations.html#protocol_property_declaration) +> *協議成員聲明* → [*協議方法聲明*](..\chapter3\05_Declarations.html#protocol_method_declaration) +> *協議成員聲明* → [*協議構造器聲明*](..\chapter3\05_Declarations.html#protocol_initializer_declaration) +> *協議成員聲明* → [*協議附屬腳本聲明*](..\chapter3\05_Declarations.html#protocol_subscript_declaration) +> *協議成員聲明* → [*協議關聯類型聲明*](..\chapter3\05_Declarations.html#protocol_associated_type_declaration) +> *協議成員聲明(Declarations)列表* → [*協議成員聲明*](..\chapter3\05_Declarations.html#protocol_member_declaration) [*協議成員聲明(Declarations)列表*](..\chapter3\05_Declarations.html#protocol_member_declarations) _可選_ + + +###協議屬性聲明 + +協議聲明了一致性類型必須在協議聲明的主體裡通過引入一個協議屬性聲明來實現一個屬性。協議屬性聲明有一種特殊的類型聲明形式： + +> var `property name`: `type` { get set } + +同其它協議成員聲明一樣，這些屬性聲明僅僅針對符合該協議的類型聲明了`getter`和`setter`要求。結果就是你不需要在協議裡它被聲明的地方實現`getter`和`setter`。 + +`getter`和`setter`要求可以通過一致性類型以各種方式滿足。如果屬性聲明包含`get`和`set`關鍵詞，一致性類型就可以用可讀寫（實現了`getter`和`setter`）的存儲型變量屬性或計算型屬性，但是屬性不能以常量屬性或只讀計算型屬性實現。如果屬性聲明僅僅包含`get`關鍵詞的話，它可以作為任意類型的屬性被實現。比如說實現了協議的屬性要求的一致性類型，參見[屬性要求](../chapter2/21_Protocols.html#property_requirements) + +更多參見[變量聲明](../chapter3/05_Declarations.html#variable_declaration) + +> 協議屬性聲明語法 +> *協議屬性聲明* → [*變量聲明頭(Head)*](..\chapter3\05_Declarations.html#variable_declaration_head) [*變量名*](..\chapter3\05_Declarations.html#variable_name) [*類型註解*](..\chapter3\03_Types.html#type_annotation) [*getter-setter關鍵字(Keyword)塊*](..\chapter3\05_Declarations.html#getter_setter_keyword_block) + +###協議方法聲明 + +協議聲明了一致性類型必須在協議聲明的主體裡通過引入一個協議方法聲明來實現一個方法. +協議方法聲明和函數方法聲明有著相同的形式，包含如下兩條規則：它們不包括函數體，你不能在類的聲明內為它們的 +參數提供初始值.舉例來說，符合的類型執行協議必需的方法。參見必需方法一節。 + +使用關鍵字class可以在協議聲明中聲明一個類或必需的靜態方法。執行這些方法的類也用關鍵字class聲明。 +相反的，執行這些方法的結構體必須以關鍵字static聲明。如果你想使用擴展方法，在擴展類時使用class關鍵字， +在擴展結構體時使用static關鍵字。 + +更多請參閱函數聲明。 + +> 協議方法聲明語法 +> *協議方法聲明* → [*函數頭*](..\chapter3\05_Declarations.html#function_head) [*函數名*](..\chapter3\05_Declarations.html#function_name) [*泛型參數子句*](GenericParametersAndArguments.html#generic_parameter_clause) _可選_ [*函數簽名(Signature)*](..\chapter3\05_Declarations.html#function_signature) + +###協議構造器聲明 + +協議聲明了一致性類型必須在協議聲明的主體裡通過引入一個協議構造器聲明來實現一個構造器。協議構造器聲明 +除了不包含構造器體外，和構造器聲明有著相同的形式， + +更多請參閱構造器聲明。 + +> 協議構造器聲明語法 +> *協議構造器聲明* → [*構造器頭(Head)*](..\chapter3\05_Declarations.html#initializer_head) [*泛型參數子句*](GenericParametersAndArguments.html#generic_parameter_clause) _可選_ [*參數子句*](..\chapter3\05_Declarations.html#parameter_clause) + +###協議下標腳本聲明 + +協議聲明了一致性類型必須在協議聲明的主體裡通過引入一個協議下標腳本聲明來實現一個下標腳本。協議屬性聲明 +對下標腳本聲明有一個特殊的形式： + +> subscript (`parameters`) -> `return type` { get set } + +下標腳本聲明只為和協議一致的類型聲明了必需的最小數量的的getter和setter。如果下標腳本申明包含get和set關鍵字， +一致的類型也必須有一個getter和setter語句。如果下標腳本聲明值包含get關鍵字，一致的類型必須至少包含一個 +getter語句，可以選擇是否包含setter語句。 + +更多參閱下標腳本聲明。 + +> 協議附屬腳本聲明語法 +> *協議附屬腳本聲明* → [*附屬腳本頭(Head)*](..\chapter3\05_Declarations.html#subscript_head) [*附屬腳本結果(Result)*](..\chapter3\05_Declarations.html#subscript_result) [*getter-setter關鍵字(Keyword)塊*](..\chapter3\05_Declarations.html#getter_setter_keyword_block) + +###協議相關類型聲明 + +協議聲明相關類型使用關鍵字typealias。相關類型為作為協議聲明的一部分的類型提供了一個別名。相關類型和參數 +語句中的類型參數很相似，但是它們在聲明的協議中包含self關鍵字。在這些語句中，self指代和協議一致的可能的類型。 +獲得更多信息和例子，查看相關類型或類型別名聲明。 + +> 協議關聯類型聲明語法 +> *協議關聯類型聲明* → [*類型別名頭(Head)*](..\chapter3\05_Declarations.html#typealias_head) [*類型繼承子句*](..\chapter3\03_Types.html#type_inheritance_clause) _可選_ [*類型別名賦值*](..\chapter3\05_Declarations.html#typealias_assignment) _可選_ + + +##構造器聲明 + +構造器聲明會為程序內的類，結構體或枚舉引入構造器。構造器使用關鍵字Init來聲明，遵循兩條基本形式。 + +結構體，枚舉，類可以有任意數量的構造器，但是類的構造器的規則和行為是不一樣的。不像結構體和枚舉那樣，類 +有兩種結構體，designed initializers 和convenience initializers，參見構造器一節。 + +如下的形式聲明了結構體，枚舉和類的指定構造器： + +> init(`parameters`) { +> `statements` +> } + +類的指定構造器將類的所有屬性直接初始化。如果類有超類，它不能調用該類的其他構造器,它只能調用超類的一個 +指定構造器。如果該類從它的超類處繼承了任何屬性，這些屬性在當前類內被賦值或修飾時，必須調用一個超類的 +指定構造器。 + +指定構造器可以在類聲明的上下文中聲明，因此它不能用擴展聲明的方法加入一個類中。 + +結構體和枚舉的構造器可以調用其他的已聲明的構造器，委託其中一個或所有的構造器進行初始化過程。 + +以關鍵字convenience來聲明一個類的便利構造器： + +> convenience init(`parameters`) { +> `statements` +> } + +便利構造器可以將初始化過程委託給另一個便利構造器或類的一個指定構造器。這意味著，類的初始化過程必須 +以一個將所有類屬性完全初始化的指定構造器的調用作為結束。便利構造器不能調用超類的構造器。 + +你可以使用required關鍵字，將便利構造器和指定構造器標記為每個子類的構造器都必須擁有的。因為指定構造器 +不被子類繼承，它們必須被立即執行。當子類直接執行所有超類的指定構造器(或使用便利構造器重寫指定構造器)時， +必需的便利構造器可以被隱式的執行，亦可以被繼承。不像方法，下標腳本那樣，你不需要為這些重寫的構造器標注 +overrride關鍵字。 + +查看更多關於不同聲明方法的構造器的例子，參閱構造過程一節。 + +> 構造器聲明語法 +> *構造器聲明* → [*構造器頭(Head)*](..\chapter3\05_Declarations.html#initializer_head) [*泛型參數子句*](GenericParametersAndArguments.html#generic_parameter_clause) _可選_ [*參數子句*](..\chapter3\05_Declarations.html#parameter_clause) [*構造器主體*](..\chapter3\05_Declarations.html#initializer_body) +> *構造器頭(Head)* → [*特性(Attributes)列表*](..\chapter3\06_Attributes.html#attributes) _可選_ **convenience** _可選_ **init** +> *構造器主體* → [*代碼塊*](..\chapter3\05_Declarations.html#code_block) + + +##析構聲明 + +析構聲明為類聲明了一個析構器。析構器沒有參數，遵循如下的格式： + +> deinit { +> `statements` +> } + +當類沒有任何語句時將要被釋放時，析構器會自動的被調用。析構器在類的聲明體內只能被聲明一次——但是不能在 +類的擴展聲明內，每個類最多只能有一個。 + +子類繼承了它的超類的析構器，在子類將要被釋放時隱式的調用。子類在所有析構器被執行完畢前不會被釋放。 + +析構器不會被直接調用。 + +查看例子和如何在類的聲明中使用析構器，參見析構過程一節。 + +> 析構器聲明語法 +> *析構器聲明* → [*特性(Attributes)列表*](..\chapter3\06_Attributes.html#attributes) _可選_ **deinit** [*代碼塊*](..\chapter3\05_Declarations.html#code_block) + + +##擴展聲明 + +擴展聲明用於擴展一個現存的類，結構體，枚舉的行為。擴展聲明以關鍵字extension開始，遵循如下的規則： + +> extension `type`: `adopted protocols` { +> `declarations` +> } + +一個擴展聲明體包括零個或多個聲明。這些聲明可以包括計算型屬性，計算型靜態屬性，實例方法，靜態和類方法，構造器， +下標腳本聲明，甚至其他結構體，類，和枚舉聲明。擴展聲明不能包含析構器，協議聲明，存儲型屬性，屬性監測器或其他 +的擴展屬性。詳細討論和查看包含多種擴展聲明的實例，參見擴展一節。 + +擴展聲明可以向現存的類，結構體，枚舉內添加一致的協議。擴展聲明不能向一個類中添加繼承的類，因此 +type-inheritance-clause是一個只包含協議列表的擴展聲明。 + +屬性，方法，現存類型的構造器不能被它們類型的擴展所重寫。 + +擴展聲明可以包含構造器聲明，這意味著，如果你擴展的類型在其他模塊中定義，構造器聲明必須委託另一個在 +那個模塊裡聲明的構造器來恰當的初始化。 + +> 擴展(Extension)聲明語法 +> *擴展聲明* → **extension** [*類型標識*](..\chapter3\03_Types.html#type_identifier) [*類型繼承子句*](..\chapter3\03_Types.html#type_inheritance_clause) _可選_ [*extension-body*](..\chapter3\05_Declarations.html#extension_body) +> *extension-body* → **{** [*聲明(Declarations)列表*](..\chapter3\05_Declarations.html#declarations) _可選_ **}** + + +##下標腳本聲明(translated by 林) + +附屬腳本用於向特定類型添加附屬腳本支持，通常為訪問集合，列表和序列的元素時提供語法便利。附屬腳本聲明使用關鍵字`subscript`，聲明形式如下： + +> subscript (`parameter`) -> (return type){ +> get{ +> `statements` +> } +> set(`setter name`){ +> `statements` +> } +> } + +附屬腳本聲明只能在類，結構體，枚舉，擴展和協議聲明的上下文進行聲明。 + +_變量(parameters)_指定一個或多個用於在相關類型的下標腳本中訪問元素的索引（例如，表達式`object[i]`中的`i`）。儘管用於元素訪問的索引可以是任意類型的，但是每個變量必須包含一個用於指定每種索引類型的類型標注。_返回類型(return type)_指定被訪問的元素的類型。 + +和計算性屬性一樣，下標腳本聲明支持對訪問元素的讀寫操作。getter用於讀取值，setter用於寫入值。setter子句是可選的，當僅需要一個getter子句時，可以將二者都忽略且直接返回請求的值即可。也就是說，如果使用了setter子句，就必須使用getter子句。 + +setter的名字和封閉的括號是可選的。如果使用了setter名稱，它會被當做傳給setter的變量的名稱。如果不使用setter名稱，那麼傳給setter的變量的名稱默認是`value`。setter名稱的類型必須與_返回類型(return type)_的類型相同。 + +可以在下標腳本聲明的類型中，可以重載下標腳本，只要_變量(parameters)_或_返回類型(return type)_與先前的不同即可。此時，必須使用`override`關鍵字聲明那個被覆蓋的下標腳本。(註：好亂啊！到底是重載還是覆蓋？！) + +同樣可以在協議聲明的上下文中聲明下標腳本，[Protocol Subscript Declaration](https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/Declarations.html#//apple_ref/doc/uid/TP40014097-CH34-XID_619)中有所描述。 + +更多關於下標腳本和下標腳本聲明的例子，請參考[Subscripts](https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/Subscripts.html#//apple_ref/doc/uid/TP40014097-CH16-XID_393)。 + +> 附屬腳本聲明語法 +> *附屬腳本聲明* → [*附屬腳本頭(Head)*](..\chapter3\05_Declarations.html#subscript_head) [*附屬腳本結果(Result)*](..\chapter3\05_Declarations.html#subscript_result) [*代碼塊*](..\chapter3\05_Declarations.html#code_block) +> *附屬腳本聲明* → [*附屬腳本頭(Head)*](..\chapter3\05_Declarations.html#subscript_head) [*附屬腳本結果(Result)*](..\chapter3\05_Declarations.html#subscript_result) [*getter-setter塊*](..\chapter3\05_Declarations.html#getter_setter_block) +> *附屬腳本聲明* → [*附屬腳本頭(Head)*](..\chapter3\05_Declarations.html#subscript_head) [*附屬腳本結果(Result)*](..\chapter3\05_Declarations.html#subscript_result) [*getter-setter關鍵字(Keyword)塊*](..\chapter3\05_Declarations.html#getter_setter_keyword_block) +> *附屬腳本頭(Head)* → [*特性(Attributes)列表*](..\chapter3\06_Attributes.html#attributes) _可選_ **subscript** [*參數子句*](..\chapter3\05_Declarations.html#parameter_clause) +> *附屬腳本結果(Result)* → **->** [*特性(Attributes)列表*](..\chapter3\06_Attributes.html#attributes) _可選_ [*類型*](..\chapter3\03_Types.html#type) + + +##運算符聲明(translated by 林) + +運算符聲明會向程序中引入中綴、前綴或後綴運算符，它使用上下文關鍵字`operator`聲明。 +可以聲明三種不同的綴性：中綴、前綴和後綴。操作符的綴性描述了操作符與它的操作數的相對位置。 +運算符聲明有三種基本形式，每種綴性各一種。運算符的綴性通過在`operator`和運算符之間添加上下文關鍵字`infix`，`prefix`或`postfix`來指定。每種形式中，運算符的名字只能包含[Operators](https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/LexicalStructure.html#//apple_ref/doc/uid/TP40014097-CH30-XID_871)中定義的運算符字符。 + +下面的這種形式聲明了一個新的中綴運算符： +> operator infix `operator name`{ +> previewprecedence `precedence level` +> associativity `associativity` +> } + +_中綴_運算符是二元運算符，它可以被置於兩個操作數之間，比如表達式`1 + 2` 中的加法運算符(`+`)。 + +中綴運算符可以可選地指定優先級，結合性，或兩者同時指定。 + +運算符的_優先級_可以指定在沒有括號包圍的情況下，運算符與它的操作數如何緊密綁定的。可以使用上下文關鍵字`precedence`並_優先級(precedence level)_一起來指定一個運算符的優先級。_優先級_可以是0到255之間的任何一個數字(十進制整數)；與十進制整數字面量不同的是，它不可以包含任何下劃線字符。儘管優先級是一個特定的數字，但它僅用作與另一個運算符比較(大小)。也就是說，一個操作數可以同時被兩個運算符使用時，例如`2 + 3 * 5`，優先級更高的運算符將優先與操作數綁定。 + +運算符的_結合性_可以指定在沒有括號包圍的情況下，優先級相同的運算符以何種順序被分組的。可以使用上下文關鍵字`associativity`並_結合性(associativity)_一起來指定一個運算符的結合性，其中_結合性_可以說是上下文關鍵字`left`，`right`或`none`中的任何一個。左結合運算符以從左到右的形式分組。例如，減法運算符(`-`)具有左結合性，因此`4 - 5 - 6`被以`(4 - 5) - 6`的形式分組，其結果為`-7`。 +右結合運算符以從右到左的形式分組，對於設置為`none`的非結合運算符，它們不以任何形式分組。具有相同優先級的非結合運算符，不可以互相鄰接。例如，表達式`1 < 2 < 3`非法的。 + +聲明時不指定任何優先級或結合性的中綴運算符，它們的優先級會被初始化為100，結合性被初始化為`none`。 + +下面的這種形式聲明了一個新的前綴運算符： +> operator prefix `operator name`{} + +緊跟在操作數前邊的_前綴運算符(prefix operator)_是一元運算符，例如表達式`++i`中的前綴遞增運算符(`++`)。 + +前綴運算符的聲明中不指定優先級。前綴運算符是非結合的。 + +下面的這種形式聲明了一個新的後綴運算符： + +> operator postfix `operator name`{} + +緊跟在操作數後邊的_後綴運算符(postfix operator)_是一元運算符，例如表達式`i++`中的前綴遞增運算符(`++`)。 + +和前綴運算符一樣，後綴運算符的聲明中不指定優先級。後綴運算符是非結合的。 + +聲明了一個新的運算符以後，需要聲明一個跟這個運算符同名的函數來實現這個運算符。如何實現一個新的運算符，請參考[Custom Operators](https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/AdvancedOperators.html#//apple_ref/doc/uid/TP40014097-CH27-XID_48)。 + +> 運算符聲明語法 +> *運算符聲明* → [*前置運算符聲明*](..\chapter3\05_Declarations.html#prefix_operator_declaration) | [*後置運算符聲明*](..\chapter3\05_Declarations.html#postfix_operator_declaration) | [*中置運算符聲明*](..\chapter3\05_Declarations.html#infix_operator_declaration) +> *前置運算符聲明* → **運算符** **prefix** [*運算符*](LexicalStructure.html#operator) **{** **}** +> *後置運算符聲明* → **運算符** **postfix** [*運算符*](LexicalStructure.html#operator) **{** **}** +> *中置運算符聲明* → **運算符** **infix** [*運算符*](LexicalStructure.html#operator) **{** [*中置運算符屬性*](..\chapter3\05_Declarations.html#infix_operator_attributes) _可選_ **}** +> *中置運算符屬性* → [*優先級子句*](..\chapter3\05_Declarations.html#precedence_clause) _可選_ [*結和性子句*](..\chapter3\05_Declarations.html#associativity_clause) _可選_ +> *優先級子句* → **precedence** [*優先級水平*](..\chapter3\05_Declarations.html#precedence_level) +> *優先級水平* → 數值 0 到 255 +> *結和性子句* → **associativity** [*結和性*](..\chapter3\05_Declarations.html#associativity) +> *結和性* → **left** | **right** | **none** diff --git a/source-tw/chapter3/06_Attributes.md b/source-tw/chapter3/06_Attributes.md new file mode 100644 index 00000000..11d88a10 --- /dev/null +++ b/source-tw/chapter3/06_Attributes.md @@ -0,0 +1,124 @@ +> 翻譯：[Hawstein](https://github.com/Hawstein) +> 校對：[numbbbbb](https://github.com/numbbbbb), [stanzhai](https://github.com/stanzhai) + +# 特性 +----------------- + +本頁內容包括： + +- [聲明特性](#declaration_attributes) +- [類型特性](#type_attributes) + +特性提供了關於聲明和類型的更多信息。在Swift中有兩類特性，用於修飾聲明的以及用於修飾類型的。例如，`required`特性，當應用於一個類的指定或便利初始化器聲明時，表明它的每個子類都必須實現那個初始化器。再比如`noreturn`特性，當應用於函數或方法類型時，表明該函數或方法不會返回到它的調用者。 + +通過以下方式指定一個特性：符號`@`後面跟特性名，如果包含參數，則把參數帶上： + +> @`attribute name` +> @`attribute name`(`attribute arguments`) + +有些聲明特性通過接收參數來指定特性的更多信息以及它是如何修飾一個特定的聲明的。這些特性的參數寫在小括號內，它們的格式由它們所屬的特性來定義。 + + +## 聲明特性 + +聲明特性只能應用於聲明。然而，你也可以將`noreturn`特性應用於函數或方法類型。 + +`assignment` + +該特性用於修飾重載了復合賦值運算符的函數。重載了復合賦值運算符的函數必需將它們的初始輸入參數標記為`inout`。如何使用`assignment`特性的一個例子，請見：[復合賦值運算符]()。 + +`class_protocol` + +該特性用於修飾一個協議表明該協議只能被類類型採用[待改：adopted]。 + +如果你用`objc`特性修飾一個協議，`class_protocol`特性就會隱式地應用到該協議，因此無需顯式地用`class_protocol`特性標記該協議。 + +`exported` + +該特性用於修飾導入聲明，以此來導出已導入的模塊，子模塊，或當前模塊的聲明。如果另一個模塊導入了當前模塊，那麼那個模塊可以訪問當前模塊的導出項。 + +`final` + +該特性用於修飾一個類或類中的屬性，方法，以及下標成員。如果用它修飾一個類，那麼這個類則不能被繼承。如果用它修飾類中的屬性，方法或下標，則表示在子類中，它們不能被重寫。 + +`lazy` + +該特性用於修飾類或結構體中的存儲型變量屬性，表示該屬性的初始值最多只被計算和存儲一次，且發生在第一次訪問它時。如何使用`lazy`特性的一個例子，請見：[惰性存儲型屬性]()。 + +`noreturn` + +該特性用於修飾函數或方法聲明，表明該函數或方法的對應類型，`T`，是`@noreturn T`。你可以用這個特性修飾函數或方法的類型，這樣一來，函數或方法就不會返回到它的調用者中去。 + +對於一個沒有用`noreturn`特性標記的函數或方法，你可以將它重寫(override)為用該特性標記的。相反，對於一個已經用`noreturn`特性標記的函數或方法，你則不可以將它重寫為沒使用該特性標記的。相同的規則試用於當你在一個comforming類型中實現一個協議方法時。 + +`NSCopying` + +該特性用於修飾一個類的存儲型變量屬性。該特性將使屬性的setter與屬性值的一個副本合成，由`copyWithZone`方法返回，而不是屬性本身的值。該屬性的類型必需遵循`NSCopying`協議。 + +`NSCopying`特性的行為與Objective-C中的`copy`特性相似。 + +`NSManaged` + +該特性用於修飾`NSManagedObject`子類中的存儲型變量屬性，表明屬性的存儲和實現由Core Data在運行時基於相關實體描述動態提供。 + +`objc` + +該特性用於修飾任意可以在Objective-C中表示的聲明，比如，非嵌套類，協議，類和協議中的屬性和方法（包含getter和setter），初始化器，析構器，以下下標。`objc`特性告訴編譯器該聲明可以在Objective-C代碼中使用。 + +如果你將`objc`特性應用於一個類或協議，它也會隱式地應用於那個類或協議的成員。對於標記了`objc`特性的類，編譯器會隱式地為它的子類添加`objc`特性。標記了`objc`特性的協議不能繼承自沒有標記`objc`的協議。 + +`objc`特性有一個可選的參數，由標記符組成。當你想把`objc`所修飾的實體以一個不同的名字暴露給Objective-C，你就可以使用這個特性參數。你可以使用這個參數來命名類，協議，方法，getters，setters，以及初始化器。下面的例子把`ExampleClass`中`enabled`屬性的getter暴露給Objective-C，名字是`isEnabled`，而不是它原來的屬性名。 + +```swift +@objc +class ExampleClass { + var enabled: Bool { + @objc(isEnabled) get { + // Return the appropriate value + } + } +} +``` + +`optional` + +用該特性修飾協議的屬性，方法或下標成員，表示實現這些成員並不需要一致性類型（conforming type）。 + +你只能用`optional`特性修飾那些標記了`objc`特性的協議。因此，只有類類型可以adopt和comform to那些包含可選成員需求的協議。更多關於如何使用`optional`特性以及如何訪問可選協議成員的指導，例如，當你不確定一個conforming類型是否實現了它們，請見：[可選協議需求]()。 + +`required` + +用該特性修飾一個類的指定或便利初始化器，表示該類的所有子類都必需實現該初始化器。 + +加了該特性的指定初始化器必需顯式地實現，而便利初始化器既可顯式地實現，也可以在子類實現了超類所有指定初始化器後繼承而來（或者當子類使用便利初始化器重寫了指定初始化器）。 + +### Interface Builder使用的聲明特性 + +Interface Builder特性是Interface Builder用來與Xcode同步的聲明特性。Swift提供了以下的Interface Builder特性：`IBAction`，`IBDesignable`，`IBInspectable`，以及`IBOutlet`。這些特性與Objective-C中對應的特性在概念上是相同的。 + +`IBOutlet`和`IBInspectable`用於修飾一個類的屬性聲明；`IBAction`特性用於修飾一個類的方法聲明；`IBDesignable`用於修飾類的聲明。 + + +## 類型特性 + +類型特性只能用於修飾類型。然而，你也可以用`noreturn`特性去修飾函數或方法聲明。 + +`auto_closure` + +這個特性通過自動地將表達式封閉到一個無參數閉包中來延遲表達式的求值。使用該特性修飾無參的函數或方法類型，返回表達式的類型。一個如何使用`auto_closure`特性的例子，見[函數類型]() + +`noreturn` + +該特性用於修飾函數或方法的類型，表明該函數或方法不會返回到它的調用者中去。你也可以用它標記函數或方法的聲明，表示函數或方法的相應類型，`T`，是`@noreturn T`。 + +> 特性語法 +> *特性* → **@** [*特性名*](..\chapter3\06_Attributes.html#attribute_name) [*特性參數子句*](..\chapter3\06_Attributes.html#attribute_argument_clause) _可選_ +> *特性名* → [*標識符*](LexicalStructure.html#identifier) +> *特性參數子句* → **(** [*平衡令牌列表*](..\chapter3\06_Attributes.html#balanced_tokens) _可選_ **)** +> *特性(Attributes)列表* → [*特色*](..\chapter3\06_Attributes.html#attribute) [*特性(Attributes)列表*](..\chapter3\06_Attributes.html#attributes) _可選_ +> *平衡令牌列表* → [*平衡令牌*](..\chapter3\06_Attributes.html#balanced_token) [*平衡令牌列表*](..\chapter3\06_Attributes.html#balanced_tokens) _可選_ +> *平衡令牌* → **(** [*平衡令牌列表*](..\chapter3\06_Attributes.html#balanced_tokens) _可選_ **)** +> *平衡令牌* → **[** [*平衡令牌列表*](..\chapter3\06_Attributes.html#balanced_tokens) _可選_ **]** +> *平衡令牌* → **{** [*平衡令牌列表*](..\chapter3\06_Attributes.html#balanced_tokens) _可選_ **}** +> *平衡令牌* → **任意標識符, 關鍵字, 字面量或運算符** +> *平衡令牌* → **任意標點除了(, ), [, ], {, 或 }** diff --git a/source-tw/chapter3/07_Patterns.md b/source-tw/chapter3/07_Patterns.md new file mode 100644 index 00000000..17748586 --- /dev/null +++ b/source-tw/chapter3/07_Patterns.md @@ -0,0 +1,182 @@ +> 翻譯：[honghaoz](https://github.com/honghaoz) +> 校對：[numbbbbb](https://github.com/numbbbbb), [stanzhai](https://github.com/stanzhai) + +# 模式（Patterns） +----------------- + +本頁內容包括： + +- [通配符模式（Wildcard Pattern）](#wildcard_pattern) +- [標識符模式（Identifier Pattern）](#identifier_pattern) +- [值綁定模式（Value-Binding Pattern）](#value-binding_pattern) +- [元組模式（Tuple Pattern）](#tuple_pattern) +- [枚舉用例模式（Enumeration Case Pattern）](#enumeration_case_pattern) +- [類型轉換模式（Type-Casting Patterns）](#type-casting_patterns) +- [表達式模式（Expression Pattern）](#expression_pattern) + +模式（pattern）代表了單個值或者復合值的結構。例如，元組`(1, 2)`的結構是逗號分隔的，包含兩個元素的列表。因為模式代表一種值的結構，而不是特定的某個值，你可以把模式和各種同類型的值匹配起來。比如，`(x, y)`可以匹配元組`(1, 2)`，以及任何含兩個元素的元組。除了將模式與一個值匹配外，你可以從合成值中提取出部分或全部，然後分別把各個部分和一個常量或變量綁定起來。 + +在Swift中，模式出現在變量和常量的聲明（在它們的左側），`for-in`語句和`switch`語句（在它們的case標籤）中。儘管任何模式都可以出現在`switch`語句的case標籤中，但在其他情況下，只有通配符模式（wildcard pattern），標識符模式（identifier pattern）和包含這兩種模式的模式才能出現。 + +你可以為通配符模式（wildcard pattern），標識符模式（identifier pattern）和元組模式（tuple pattern）指定類型註釋，用來限制這種模式只匹配某種類型的值。 + +> 模式(Patterns) 語法 +> *模式* → [*通配符模式*](..\chapter3\07_Patterns.html#wildcard_pattern) [*類型註解*](..\chapter3\03_Types.html#type_annotation) _可選_ +> *模式* → [*標識符模式*](..\chapter3\07_Patterns.html#identifier_pattern) [*類型註解*](..\chapter3\03_Types.html#type_annotati(Value Binding)on) _可選_ +> *模式* → [*值綁定模式*](..\chapter3\07_Patterns.html#value_binding_pattern) +> *模式* → [*元組模式*](..\chapter3\07_Patterns.html#tuple_pattern) [*類型註解*](..\chapter3\03_Types.html#type_annotation) _可選_ +> *模式* → [*enum-case-pattern*](..\chapter3\07_Patterns.html#enum_case_pattern) +> *模式* → [*type-casting-pattern*](..\chapter3\07_Patterns.html#type_casting_pattern) +> *模式* → [*表達式模式*](..\chapter3\07_Patterns.html#expression_pattern) + + +## 通配符模式（Wildcard Pattern） + +通配符模式匹配並忽略任何值，包含一個下劃線（_）。當你不關心被匹配的值時，可以使用此模式。例如，下面這段代碼進行了`1...3`的循環，並忽略了每次循環的值： + +```swift +for _ in 1...3 { + // Do something three times. +} +``` + +> 通配符模式語法 +> *通配符模式* → **_** + + +## 標識符模式（Identifier Pattern） + +標識符模式匹配任何值，並將匹配的值和一個變量或常量綁定起來。例如，在下面的常量申明中，`someValue`是一個標識符模式，匹配了類型是`Int`的`42`。 + +```swift +let someValue = 42 +``` + +當匹配成功時，`42`被綁定（賦值）給常量`someValue`。 + +當一個變量或常量申明的左邊是標識符模式時，此時，標識符模式是隱式的值綁定模式（value-binding pattern）。 + +> 標識符模式語法 +> *標識符模式* → [*標識符*](LexicalStructure.html#identifier) + + +## 值綁定模式（Value-Binding Pattern） + +值綁定模式綁定匹配的值到一個變量或常量。當綁定匹配值給常量時，用關鍵字`let`,綁定給變量時，用關鍵字`var`。 + +標識符模式包含在值綁定模式中，綁定新的變量或常量到匹配的值。例如，你可以分解一個元組的元素，並把每個元素綁定到相應的標識符模式中。 + +```swift +let point = (3, 2) +switch point { + // Bind x and y to the elements of point. +case let (x, y): + println("The point is at (\(x), \(y)).") +} +// prints "The point is at (3, 2).」 +``` + +在上面這個例子中，`let`將元組模式`(x, y)`分配到各個標識符模式。因為這種行為，`switch`語句中`case let (x, y):`和`case (let x, let y):`匹配的值是一樣的。 + +> 值綁定(Value Binding)模式語法 +> *值綁定模式* → **var** [*模式*](..\chapter3\07_Patterns.html#pattern) | **let** [*模式*](..\chapter3\07_Patterns.html#pattern) + + +## 元組模式（Tuple Pattern） + +元組模式是逗號分隔的列表，包含一個或多個模式，並包含在一對圓括號中。元組模式匹配相應元組類型的值。 + +你可以使用類型註釋來限制一個元組模式來匹配某種元組類型。例如，在常量申明`let (x, y): (Int, Int) = (1, 2)`中的元組模式`(x, y): (Int, Int)`，只匹配兩個元素都是`Int`這種類型的元組。如果僅需要限制一個元組模式中的某幾個元素，只需要直接對這幾個元素提供類型註釋即可。例如，在`let (x: String, y)`中的元組模式，只要某個元組類型是包含兩個元素，且第一個元素類型是`String`，則被匹配。 + +當元組模式被用在`for-in`語句或者變量或常量申明時，它可以包含通配符模式，標識符模式或者其他包含這兩種模式的模式。例如，下面這段代碼是不正確的，因為`(x, 0)`中的元素`0`是一個表達式模式： + +```swift +let points = [(0, 0), (1, 0), (1, 1), (2, 0), (2, 1)] +// This code isn't valid. +for (x, 0) in points { + /* ... */ +} +``` + +對於只包含一個元素的元組，括號是不起作用的。模式匹配那個單個元素的類型。例如，下面是等效的： + +```swift +let a = 2 // a: Int = 2 +let (a) = 2 // a: Int = 2 +let (a): Int = 2 // a: Int = 2 +``` + +> 元組模式語法 +> *元組模式* → **(** [*元組模式元素列表*](..\chapter3\07_Patterns.html#tuple_pattern_element_list) _可選_ **)** +> *元組模式元素列表* → [*元組模式元素*](..\chapter3\07_Patterns.html#tuple_pattern_element) | [*元組模式元素*](..\chapter3\07_Patterns.html#tuple_pattern_element) **,** [*元組模式元素列表*](..\chapter3\07_Patterns.html#tuple_pattern_element_list) +> *元組模式元素* → [*模式*](..\chapter3\07_Patterns.html#pattern) + + +## 枚舉用例模式（Enumeration Case Pattern） + +枚舉用例模式匹配現有的枚舉類型的某種用例。枚舉用例模式僅在`switch`語句中的`case`標籤中出現。 + +如果你準備匹配的枚舉用例有任何關聯的值，則相應的枚舉用例模式必須指定一個包含每個關聯值元素的元組模式。關於使用`switch`語句來匹配包含關聯值枚舉用例的例子，請參閱`Associated Values`. + +> 枚舉用例模式語法 +> *enum-case-pattern* → [*類型標識*](..\chapter3\03_Types.html#type_identifier) _可選_ **.** [*枚舉的case名*](..\chapter3\05_Declarations.html#enum_case_name) [*元組模式*](..\chapter3\07_Patterns.html#tuple_pattern) _可選_ + + +## 類型轉換模式（Type-Casting Patterns） + +有兩種類型轉換模式，`is`模式和`as`模式。這兩種模式均只出現在`switch`語句中的`case`標籤中。`is`模式和`as`模式有以下形式： + +> is `type` +> `pattern` as `type` + +`is`模式匹配一個值，如果這個值的類型在運行時（runtime）和`is`模式右邊的指定類型（或者那個類型的子類）是一致的。`is`模式和`is`操作符一樣，它們都進行類型轉換，但是拋棄了返回的類型。 + +`as`模式匹配一個值，如果這個值的類型在運行時（runtime）和`as`模式右邊的指定類型（或者那個類型的子類）是一致的。一旦匹配成功，匹配的值的類型被轉換成`as`模式左邊指定的模式。 + +關於使用`switch`語句來匹配`is`模式和`as`模式值的例子，請參閱`Type Casting for Any and AnyObject`。 + +> 類型轉換模式語法 +> *type-casting-pattern* → [*is模式*](..\chapter3\07_Patterns.html#is_pattern) | [*as模式*](..\chapter3\07_Patterns.html#as_pattern) +> *is模式* → **is** [*類型*](..\chapter3\03_Types.html#type) +> *as模式* → [*模式*](..\chapter3\07_Patterns.html#pattern) **as** [*類型*](..\chapter3\03_Types.html#type) + + +## 表達式模式（Expression Pattern） + +表達式模式代表了一個表達式的值。這個模式只出現在`switch`語句中的`case`標籤中。 + +由表達式模式所代表的表達式用Swift標準庫中的`~=`操作符與輸入表達式的值進行比較。如果`~=`操作符返回`true`，則匹配成功。默認情況下，`~=`操作符使用`==`操作符來比較兩個相同類型的值。它也可以匹配一個整數值與一個`Range`對像中的整數範圍，正如下面這個例子所示： + +```swift +let point = (1, 2) +switch point { +case (0, 0): + println("(0, 0) is at the origin.") +case (-2...2, -2...2): + println("(\(point.0), \(point.1)) is near the origin.") +default: + println("The point is at (\(point.0), \(point.1)).") +} +// prints "(1, 2) is near the origin.」 +``` + +你可以重載`~=`操作符來提供自定義的表達式行為。例如，你可以重寫上面的例子，以實現用字符串表達的點來比較`point`表達式。 + +```swift +// Overload the ~= operator to match a string with an integer +func ~=(pattern: String, value: Int) -> Bool { + return pattern == "\(value)" +} +switch point { +case ("0", "0"): + println("(0, 0) is at the origin.") +case ("-2...2", "-2...2"): + println("(\(point.0), \(point.1)) is near the origin.") +default: + println("The point is at (\(point.0), \(point.1)).") +} +// prints "(1, 2) is near the origin.」 +``` + +> 表達式模式語法 +> *表達式模式* → [*表達式*](..\chapter3\04_Expressions.html#expression) \ No newline at end of file diff --git a/source-tw/chapter3/08_Generic_Parameters_and_Arguments.md b/source-tw/chapter3/08_Generic_Parameters_and_Arguments.md new file mode 100644 index 00000000..3f878c48 --- /dev/null +++ b/source-tw/chapter3/08_Generic_Parameters_and_Arguments.md @@ -0,0 +1,106 @@ +> 翻譯：[fd5788](https://github.com/fd5788) +> 校對：[yankuangshi](https://github.com/yankuangshi), [stanzhai](https://github.com/stanzhai) + +# 泛型參數 +--------- + +本頁包含內容： + +- [泛型形參子句](#generic_parameter) +- [泛型實參子句](#generic_argument) + +本節涉及泛型類型、泛型函數以及泛型構造器的參數，包括形參和實參。聲明泛型類型、函數或構造器時，須指定相應的類型參數。類型參數相當於一個佔位符，當實例化泛型類型、調用泛型函數或泛型構造器時，就用具體的類型實參替代之。 + +關於 Swift 語言的泛型概述，見[泛型](../charpter2/22_Generics.md)(第二部分第22章)。 + + +## 泛型形參子句 + +泛型形參子句指定泛型類型或函數的類型形參，以及這些參數的關聯約束和要求。泛型形參子句用尖括號（<>）包住，並且有以下兩種形式： + +> <`generic parameter list`> +> <`generic parameter list` where `requirements`> + +泛型形參列表中泛型形參用逗號分開，每一個採用以下形式： + +> `type parameter` : `constrain` + +泛型形參由兩部分組成：類型形參及其後的可選約束。類型形參只是佔位符類型（如T，U，V，KeyType，ValueType等）的名字而已。你可以在泛型類型、函數的其餘部分或者構造器聲明，以及函數或構造器的簽名中使用它。 + +約束用於指明該類型形參繼承自某個類或者遵守某個協議或協議的一部分。例如，在下面的泛型中，泛型形參`T: Comparable`表示任何用於替代類型形參`T`的類型實參必須滿足`Comparable`協議。 + +```swift +func simpleMin(x: T, y: T) -> T { + if x < y { + return y + } + return x +} +``` + +如，`Int`和`Double`均滿足`Comparable`協議，該函數接受任何一種類型。與泛型類型相反，調用泛型函數或構造器時不需要指定泛型實參子句。類型實參由傳遞給函數或構造器的實參推斷而出。 + +```swift +simpleMin(17, 42) // T is inferred to be Int +simpleMin(3.14159, 2.71828) // T is inferred to be Double +``` + +## Where 子句 + +要想對類型形參及其關聯類型指定額外要求，可以在泛型形參列表之後添加`where`子句。`where`子句由關鍵字`where`及其後的用逗號分割的多個要求組成。 + +`where`子句中的要求用於指明該類型形參繼承自某個類或遵守某個協議或協議的一部分。儘管`where`子句有助於表達類型形參上的簡單約束（如`T: Comparable`等同於`T where T: Comparable`，等等），但是依然可以用來對類型形參及其關聯約束提供更複雜的約束。如，``表示泛型類型`T`繼承自類`C`且遵守協議`P`。 + +如上所述，可以強制約束類型形參的關聯類型遵守某個協議。``表示`T`遵守`Generator`協議，而且`T`的關聯類型`T.Element`遵守`Eauatable`協議（`T`有關聯類型是因為`Generator`聲明了`Element`，而`T`遵守`Generator`協議）。 + +也可以用操作符`==`來指定兩個類型等效的要求。例如，有這樣一個約束：`T`和`U`遵守`Generator`協議，同時要求它們的關聯類型等同，可以這樣來表達：``。 + +當然，替代類型形參的類型實參必須滿足所有類型形參所要求的約束和要求。 + +泛型函數或構造器可以重載，但在泛型形參子句中的類型形參必須有不同的約束或要求，抑或二者皆不同。當調用重載的泛型函數或構造器時，編譯器會用這些約束來決定調用哪個重載函數或構造器。 + +泛型類可以生成一個子類，但是這個子類也必須是泛型類。 + +> 泛型形參子句語法 +> *泛型參數子句* → **<** [*泛型參數列表*](GenericParametersAndArguments.html#generic_parameter_list) [*約束子句*](GenericParametersAndArguments.html#requirement_clause) _可選_ **>** +> *泛型參數列表* → [*泛形參數*](GenericParametersAndArguments.html#generic_parameter) | [*泛形參數*](GenericParametersAndArguments.html#generic_parameter) **,** [*泛型參數列表*](GenericParametersAndArguments.html#generic_parameter_list) +> *泛形參數* → [*類型名稱*](..\chapter3\03_Types.html#type_name) +> *泛形參數* → [*類型名稱*](..\chapter3\03_Types.html#type_name) **:** [*類型標識*](..\chapter3\03_Types.html#type_identifier) +> *泛形參數* → [*類型名稱*](..\chapter3\03_Types.html#type_name) **:** [*協議合成類型*](..\chapter3\03_Types.html#protocol_composition_type) +> *約束子句* → **where** [*約束列表*](GenericParametersAndArguments.html#requirement_list) +> *約束列表* → [*約束*](GenericParametersAndArguments.html#requirement) | [*約束*](GenericParametersAndArguments.html#requirement) **,** [*約束列表*](GenericParametersAndArguments.html#requirement_list) +> *約束* → [*一致性約束*](GenericParametersAndArguments.html#conformance_requirement) | [*同類型約束*](GenericParametersAndArguments.html#same_type_requirement) +> *一致性約束* → [*類型標識*](..\chapter3\03_Types.html#type_identifier) **:** [*類型標識*](..\chapter3\03_Types.html#type_identifier) +> *一致性約束* → [*類型標識*](..\chapter3\03_Types.html#type_identifier) **:** [*協議合成類型*](..\chapter3\03_Types.html#protocol_composition_type) +> *同類型約束* → [*類型標識*](..\chapter3\03_Types.html#type_identifier) **==** [*類型標識*](..\chapter3\03_Types.html#type_identifier) + + + +## 泛型實參子句 + +泛型實參子句指定_泛型類型_的類型實參。泛型實參子句用尖括號（<>）包住，形式如下： + +> <`generic argument list`> + +泛型實參列表中類型實參有逗號分開。類型實參是實際具體類型的名字，用來替代泛型類型的泛型形參子句中的相應的類型形參。從而得到泛型類型的一個特化版本。如，Swift標準庫的泛型字典類型定義如下： + +```swift +struct Dictionary: Collection, DictionaryLiteralConvertible { + /* .. */ +} +``` + +泛型`Dictionary`類型的特化版本，`Dictionary`就是用具體的`String`和`Int`類型替代泛型類型`KeyType: Hashable`和`ValueType`產生的。每一個類型實參必須滿足它所替代的泛型形參的所有約束，包括任何`where`子句所指定的額外的要求。上面的例子中，類型形參`KeyType`要求滿足`Hashable`協議，因此`String`也必須滿足`Hashable`協議。 + +可以用本身就是泛型類型的特化版本的類型實參替代類型形參（假設已滿足合適的約束和要求）。例如，為了生成一個元素類型是整型數組的數組，可以用數組的特化版本`Array`替代泛型類型`Array`的類型形參`T`來實現。 + +```swift +let arrayOfArrays: Array> = [[1, 2, 3], [4, 5, 6], [7, 8, 9]] +``` + +如[泛型形參子句](#generic_parameter)所述，不能用泛型實參子句來指定泛型函數或構造器的類型實參。 + +> 泛型實參子句語法 +> *(泛型參數子句Generic Argument Clause)* → **<** [*泛型參數列表*](GenericParametersAndArguments.html#generic_argument_list) **>** +> *泛型參數列表* → [*泛型參數*](GenericParametersAndArguments.html#generic_argument) | [*泛型參數*](GenericParametersAndArguments.html#generic_argument) **,** [*泛型參數列表*](GenericParametersAndArguments.html#generic_argument_list) +> *泛型參數* → [*類型*](..\chapter3\03_Types.html#type) \ No newline at end of file diff --git a/source-tw/chapter3/09_Summary_of_the_Grammar.md b/source-tw/chapter3/09_Summary_of_the_Grammar.md new file mode 100644 index 00000000..644d4a65 --- /dev/null +++ b/source-tw/chapter3/09_Summary_of_the_Grammar.md @@ -0,0 +1,743 @@ +> 翻譯：[stanzhai](https://github.com/stanzhai) +> 校對：[xielingwang](https://github.com/xielingwang) + +# 語法總結 +_________________ + +本頁包含內容： + +* [語句（Statements）](#statements) +* [泛型參數（Generic Parameters and Arguments）](#generic_parameters_and_arguments) +* [聲明（Declarations）](#declarations) +* [模式（Patterns）](#patterns) +* [特性（Attributes）](#attributes) +* [表達式（Expressions）](#expressions) +* [詞法結構（Lexical Structure）](#lexical_structure) +* [類型（Types）](#types) + + +## 語句 + +> 語句語法 +> *語句* → [*表達式*](..\chapter3\04_Expressions.html#expression) **;** _可選_ +> *語句* → [*聲明*](..\chapter3\05_Declarations.html#declaration) **;** _可選_ +> *語句* → [*循環語句*](..\chapter3\10_Statements.html#loop_statement) **;** _可選_ +> *語句* → [*分支語句*](..\chapter3\10_Statements.html#branch_statement) **;** _可選_ +> *語句* → [*標記語句(Labeled Statement)*](..\chapter3\10_Statements.html#labeled_statement) +> *語句* → [*控制轉移語句*](..\chapter3\10_Statements.html#control_transfer_statement) **;** _可選_ +> *多條語句(Statements)* → [*語句*](..\chapter3\10_Statements.html#statement) [*多條語句(Statements)*](..\chapter3\10_Statements.html#statements) _可選_ + + + +> 循環語句語法 +> *循環語句* → [*for語句*](..\chapter3\10_Statements.html#for_statement) +> *循環語句* → [*for-in語句*](..\chapter3\10_Statements.html#for_in_statement) +> *循環語句* → [*while語句*](..\chapter3\10_Statements.html#wheetatype類型ile_statement) +> *循環語句* → [*do-while語句*](..\chapter3\10_Statements.html#do_while_statement) + + + +> For 循環語法 +> *for語句* → **for** [*for初始條件*](..\chapter3\10_Statements.html#for_init) _可選_ **;** [*表達式*](..\chapter3\04_Expressions.html#expression) _可選_ **;** [*表達式*](..\chapter3\04_Expressions.html#expression) _可選_ [*代碼塊*](..\chapter3\05_Declarations.html#code_block) +> *for語句* → **for** **(** [*for初始條件*](..\chapter3\10_Statements.html#for_init) _可選_ **;** [*表達式*](..\chapter3\04_Expressions.html#expression) _可選_ **;** [*表達式*](..\chapter3\04_Expressions.html#expression) _可選_ **)** [*代碼塊*](..\chapter3\05_Declarations.html#code_block) +> *for初始條件* → [*變量聲明*](..\chapter3\05_Declarations.html#variable_declaration) | [*表達式列表*](..\chapter3\04_Expressions.html#expression_list) + + + +> For-In 循環語法 +> *for-in語句* → **for** [*模式*](..\chapter3\07_Patterns.html#pattern) **in** [*表達式*](..\chapter3\04_Expressions.html#expression) [*代碼塊*](..\chapter3\05_Declarations.html#code_block) + + + +> While 循環語法 +> *while語句* → **while** [*while條件*](..\chapter3\10_Statements.html#while_condition) [*代碼塊*](..\chapter3\05_Declarations.html#code_block) +> *while條件* → [*表達式*](..\chapter3\04_Expressions.html#expression) | [*聲明*](..\chapter3\05_Declarations.html#declaration) + + + +> Do-While 循環語法 +> *do-while語句* → **do** [*代碼塊*](..\chapter3\05_Declarations.html#code_block) **while** [*while條件*](..\chapter3\10_Statements.html#while_condition) + + + +> 分支語句語法 +> *分支語句* → [*if語句*](..\chapter3\10_Statements.html#if_statement) +> *分支語句* → [*switch語句*](..\chapter3\10_Statements.html#switch_statement) + + + +> If語句語法 +> *if語句* → **if** [*if條件*](..\chapter3\10_Statements.html#if_condition) [*代碼塊*](..\chapter3\05_Declarations.html#code_block) [*else子句(Clause)*](..\chapter3\10_Statements.html#else_clause) _可選_ +> *if條件* → [*表達式*](..\chapter3\04_Expressions.html#expression) | [*聲明*](..\chapter3\05_Declarations.html#declaration) +> *else子句(Clause)* → **else** [*代碼塊*](..\chapter3\05_Declarations.html#code_block) | **else** [*if語句*](..\chapter3\10_Statements.html#if_statement) + + + +> Switch語句語法 +> *switch語句* → **switch** [*表達式*](..\chapter3\04_Expressions.html#expression) **{** [*SwitchCase列表*](..\chapter3\10_Statements.html#switch_cases) _可選_ **}** +> *SwitchCase列表* → [*SwitchCase*](..\chapter3\10_Statements.html#switch_case) [*SwitchCase列表*](..\chapter3\10_Statements.html#switch_cases) _可選_ +> *SwitchCase* → [*case標籤*](..\chapter3\10_Statements.html#case_label) [*多條語句(Statements)*](..\chapter3\10_Statements.html#statements) | [*default標籤*](..\chapter3\10_Statements.html#default_label) [*多條語句(Statements)*](..\chapter3\10_Statements.html#statements) +> *SwitchCase* → [*case標籤*](..\chapter3\10_Statements.html#case_label) **;** | [*default標籤*](..\chapter3\10_Statements.html#default_label) **;** +> *case標籤* → **case** [*case項列表*](..\chapter3\10_Statements.html#case_item_list) **:** +> *case項列表* → [*模式*](..\chapter3\07_Patterns.html#pattern) [*guard-clause*](..\chapter3\10_Statements.html#guard_clause) _可選_ | [*模式*](..\chapter3\07_Patterns.html#pattern) [*guard-clause*](..\chapter3\10_Statements.html#guard_clause) _可選_ **,** [*case項列表*](..\chapter3\10_Statements.html#case_item_list) +> *default標籤* → **default** **:** +> *guard-clause* → **where** [*guard-expression*](..\chapter3\10_Statements.html#guard_expression) +> *guard-expression* → [*表達式*](..\chapter3\04_Expressions.html#expression) + + + +> 標記語句語法 +> *標記語句(Labeled Statement)* → [*語句標籤*](..\chapter3\10_Statements.html#statement_label) [*循環語句*](..\chapter3\10_Statements.html#loop_statement) | [*語句標籤*](..\chapter3\10_Statements.html#statement_label) [*switch語句*](..\chapter3\10_Statements.html#switch_statement) +> *語句標籤* → [*標籤名稱*](..\chapter3\10_Statements.html#label_name) **:** +> *標籤名稱* → [*標識符*](..\chapter3\02_Lexical_Structure.html#identifier) + + + +> 控制傳遞語句(Control Transfer Statement) 語法 +> *控制傳遞語句* → [*break語句*](..\chapter3\10_Statements.html#break_statement) +> *控制傳遞語句* → [*continue語句*](..\chapter3\10_Statements.html#continue_statement) +> *控制傳遞語句* → [*fallthrough語句*](..\chapter3\10_Statements.html#fallthrough_statement) +> *控制傳遞語句* → [*return語句*](..\chapter3\10_Statements.html#return_statement) + + + +> Break 語句語法 +> *break語句* → **break** [*標籤名稱*](..\chapter3\10_Statements.html#label_name) _可選_ + + + +> Continue 語句語法 +> *continue語句* → **continue** [*標籤名稱*](..\chapter3\10_Statements.html#label_name) _可選_ + + + +> Fallthrough 語句語法 +> *fallthrough語句* → **fallthrough** + + + +> Return 語句語法 +> *return語句* → **return** [*表達式*](..\chapter3\04_Expressions.html#expression) _可選_ + + +## 泛型參數 + +> 泛型形參子句(Generic Parameter Clause) 語法 +> *泛型參數子句* → **<** [*泛型參數列表*](GenericParametersAndArguments.html#generic_parameter_list) [*約束子句*](GenericParametersAndArguments.html#requirement_clause) _可選_ **>** +> *泛型參數列表* → [*泛形參數*](GenericParametersAndArguments.html#generic_parameter) | [*泛形參數*](GenericParametersAndArguments.html#generic_parameter) **,** [*泛型參數列表*](GenericParametersAndArguments.html#generic_parameter_list) +> *泛形參數* → [*類型名稱*](..\chapter3\03_Types.html#type_name) +> *泛形參數* → [*類型名稱*](..\chapter3\03_Types.html#type_name) **:** [*類型標識*](..\chapter3\03_Types.html#type_identifier) +> *泛形參數* → [*類型名稱*](..\chapter3\03_Types.html#type_name) **:** [*協議合成類型*](..\chapter3\03_Types.html#protocol_composition_type) +> *約束子句* → **where** [*約束列表*](GenericParametersAndArguments.html#requirement_list) +> *約束列表* → [*約束*](GenericParametersAndArguments.html#requirement) | [*約束*](GenericParametersAndArguments.html#requirement) **,** [*約束列表*](GenericParametersAndArguments.html#requirement_list) +> *約束* → [*一致性約束*](GenericParametersAndArguments.html#conformance_requirement) | [*同類型約束*](GenericParametersAndArguments.html#same_type_requirement) +> *一致性約束* → [*類型標識*](..\chapter3\03_Types.html#type_identifier) **:** [*類型標識*](..\chapter3\03_Types.html#type_identifier) +> *一致性約束* → [*類型標識*](..\chapter3\03_Types.html#type_identifier) **:** [*協議合成類型*](..\chapter3\03_Types.html#protocol_composition_type) +> *同類型約束* → [*類型標識*](..\chapter3\03_Types.html#type_identifier) **==** [*類型標識*](..\chapter3\03_Types.html#type_identifier) + + + +> 泛型實參子句語法 +> *(泛型參數子句Generic Argument Clause)* → **<** [*泛型參數列表*](GenericParametersAndArguments.html#generic_argument_list) **>** +> *泛型參數列表* → [*泛型參數*](GenericParametersAndArguments.html#generic_argument) | [*泛型參數*](GenericParametersAndArguments.html#generic_argument) **,** [*泛型參數列表*](GenericParametersAndArguments.html#generic_argument_list) +> *泛型參數* → [*類型*](..\chapter3\03_Types.html#type) + + +## 聲明 (Declarations) + +> 聲明語法 +> *聲明* → [*導入聲明*](..\chapter3\05_Declarations.html#import_declaration) +> *聲明* → [*常量聲明*](..\chapter3\05_Declarations.html#constant_declaration) +> *聲明* → [*變量聲明*](..\chapter3\05_Declarations.html#variable_declaration) +> *聲明* → [*類型別名聲明*](..\chapter3\05_Declarations.html#typealias_declaration) +> *聲明* → [*函數聲明*](..\chapter3\05_Declarations.html#function_declaration) +> *聲明* → [*枚舉聲明*](..\chapter3\05_Declarations.html#enum_declaration) +> *聲明* → [*結構體聲明*](..\chapter3\05_Declarations.html#struct_declaration) +> *聲明* → [*類聲明*](..\chapter3\05_Declarations.html#class_declaration) +> *聲明* → [*協議聲明*](..\chapter3\05_Declarations.html#protocol_declaration) +> *聲明* → [*構造器聲明*](..\chapter3\05_Declarations.html#initializer_declaration) +> *聲明* → [*析構器聲明*](..\chapter3\05_Declarations.html#deinitializer_declaration) +> *聲明* → [*擴展聲明*](..\chapter3\05_Declarations.html#extension_declaration) +> *聲明* → [*下標腳本聲明*](..\chapter3\05_Declarations.html#subscript_declaration) +> *聲明* → [*運算符聲明*](..\chapter3\05_Declarations.html#operator_declaration) +> *聲明(Declarations)列表* → [*聲明*](..\chapter3\05_Declarations.html#declaration) [*聲明(Declarations)列表*](..\chapter3\05_Declarations.html#declarations) _可選_ +> *聲明描述符(Specifiers)列表* → [*聲明描述符(Specifier)*](..\chapter3\05_Declarations.html#declaration_specifier) [*聲明描述符(Specifiers)列表*](..\chapter3\05_Declarations.html#declaration_specifiers) _可選_ +> *聲明描述符(Specifier)* → **class** | **mutating** | **nonmutating** | **override** | **static** | **unowned** | **unowned(safe)** | **unowned(unsafe)** | **weak** + + + +> 頂級(Top Level) 聲明語法 +> *頂級聲明* → [*多條語句(Statements)*](..\chapter3\10_Statements.html#statements) _可選_ + + + +> 代碼塊語法 +> *代碼塊* → **{** [*多條語句(Statements)*](..\chapter3\10_Statements.html#statements) _可選_ **}** + + + +> 導入(Import)聲明語法 +> *導入聲明* → [*特性(Attributes)列表*](..\chapter3\06_Attributes.html#attributes) _可選_ **import** [*導入類型*](..\chapter3\05_Declarations.html#import_kind) _可選_ [*導入路徑*](..\chapter3\05_Declarations.html#import_path) +> *導入類型* → **typealias** | **struct** | **class** | **enum** | **protocol** | **var** | **func** +> *導入路徑* → [*導入路徑標識符*](..\chapter3\05_Declarations.html#import_path_identifier) | [*導入路徑標識符*](..\chapter3\05_Declarations.html#import_path_identifier) **.** [*導入路徑*](..\chapter3\05_Declarations.html#import_path) +> *導入路徑標識符* → [*標識符*](..\chapter3\02_Lexical_Structure.html#identifier) | [*運算符*](..\chapter3\02_Lexical_Structure.html#operator) + + + +> 常數聲明語法 +> *常量聲明* → [*特性(Attributes)列表*](..\chapter3\06_Attributes.html#attributes) _可選_ [*聲明描述符(Specifiers)列表*](..\chapter3\05_Declarations.html#declaration_specifiers) _可選_ **let** [*模式構造器列表*](..\chapter3\05_Declarations.html#pattern_initializer_list) +> *模式構造器列表* → [*模式構造器*](..\chapter3\05_Declarations.html#pattern_initializer) | [*模式構造器*](..\chapter3\05_Declarations.html#pattern_initializer) **,** [*模式構造器列表*](..\chapter3\05_Declarations.html#pattern_initializer_list) +> *模式構造器* → [*模式*](..\chapter3\07_Patterns.html#pattern) [*構造器*](..\chapter3\05_Declarations.html#initializer) _可選_ +> *構造器* → **=** [*表達式*](..\chapter3\04_Expressions.html#expression) + + + +> 變量聲明語法 +> *變量聲明* → [*變量聲明頭(Head)*](..\chapter3\05_Declarations.html#variable_declaration_head) [*模式構造器列表*](..\chapter3\05_Declarations.html#pattern_initializer_list) +> *變量聲明* → [*變量聲明頭(Head)*](..\chapter3\05_Declarations.html#variable_declaration_head) [*變量名*](..\chapter3\05_Declarations.html#variable_name) [*類型註解*](..\chapter3\03_Types.html#type_annotation) [*代碼塊*](..\chapter3\05_Declarations.html#code_block) +> *變量聲明* → [*變量聲明頭(Head)*](..\chapter3\05_Declarations.html#variable_declaration_head) [*變量名*](..\chapter3\05_Declarations.html#variable_name) [*類型註解*](..\chapter3\03_Types.html#type_annotation) [*getter-setter塊*](..\chapter3\05_Declarations.html#getter_setter_block) +> *變量聲明* → [*變量聲明頭(Head)*](..\chapter3\05_Declarations.html#variable_declaration_head) [*變量名*](..\chapter3\05_Declarations.html#variable_name) [*類型註解*](..\chapter3\03_Types.html#type_annotation) [*getter-setter關鍵字(Keyword)塊*](..\chapter3\05_Declarations.html#getter_setter_keyword_block) +> *變量聲明* → [*變量聲明頭(Head)*](..\chapter3\05_Declarations.html#variable_declaration_head) [*變量名*](..\chapter3\05_Declarations.html#variable_name) [*類型註解*](..\chapter3\03_Types.html#type_annotation) [*構造器*](..\chapter3\05_Declarations.html#initializer) _可選_ [*willSet-didSet代碼塊*](..\chapter3\05_Declarations.html#willSet_didSet_block) +> *變量聲明頭(Head)* → [*特性(Attributes)列表*](..\chapter3\06_Attributes.html#attributes) _可選_ [*聲明描述符(Specifiers)列表*](..\chapter3\05_Declarations.html#declaration_specifiers) _可選_ **var** +> *變量名稱* → [*標識符*](..\chapter3\02_Lexical_Structure.html#identifier) +> *getter-setter塊* → **{** [*getter子句*](..\chapter3\05_Declarations.html#getter_clause) [*setter子句*](..\chapter3\05_Declarations.html#setter_clause) _可選_ **}** +> *getter-setter塊* → **{** [*setter子句*](..\chapter3\05_Declarations.html#setter_clause) [*getter子句*](..\chapter3\05_Declarations.html#getter_clause) **}** +> *getter子句* → [*特性(Attributes)列表*](..\chapter3\06_Attributes.html#attributes) _可選_ **get** [*代碼塊*](..\chapter3\05_Declarations.html#code_block) +> *setter子句* → [*特性(Attributes)列表*](..\chapter3\06_Attributes.html#attributes) _可選_ **set** [*setter名稱*](..\chapter3\05_Declarations.html#setter_name) _可選_ [*代碼塊*](..\chapter3\05_Declarations.html#code_block) +> *setter名稱* → **(** [*標識符*](..\chapter3\02_Lexical_Structure.html#identifier) **)** +> *getter-setter關鍵字(Keyword)塊* → **{** [*getter關鍵字(Keyword)子句*](..\chapter3\05_Declarations.html#getter_keyword_clause) [*setter關鍵字(Keyword)子句*](..\chapter3\05_Declarations.html#setter_keyword_clause) _可選_ **}** +> *getter-setter關鍵字(Keyword)塊* → **{** [*setter關鍵字(Keyword)子句*](..\chapter3\05_Declarations.html#setter_keyword_clause) [*getter關鍵字(Keyword)子句*](..\chapter3\05_Declarations.html#getter_keyword_clause) **}** +> *getter關鍵字(Keyword)子句* → [*特性(Attributes)列表*](..\chapter3\06_Attributes.html#attributes) _可選_ **get** +> *setter關鍵字(Keyword)子句* → [*特性(Attributes)列表*](..\chapter3\06_Attributes.html#attributes) _可選_ **set** +> *willSet-didSet代碼塊* → **{** [*willSet子句*](..\chapter3\05_Declarations.html#willSet_clause) [*didSet子句*](..\chapter3\05_Declarations.html#didSet_clause) _可選_ **}** +> *willSet-didSet代碼塊* → **{** [*didSet子句*](..\chapter3\05_Declarations.html#didSet_clause) [*willSet子句*](..\chapter3\05_Declarations.html#willSet_clause) **}** +> *willSet子句* → [*特性(Attributes)列表*](..\chapter3\06_Attributes.html#attributes) _可選_ **willSet** [*setter名稱*](..\chapter3\05_Declarations.html#setter_name) _可選_ [*代碼塊*](..\chapter3\05_Declarations.html#code_block) +> *didSet子句* → [*特性(Attributes)列表*](..\chapter3\06_Attributes.html#attributes) _可選_ **didSet** [*setter名稱*](..\chapter3\05_Declarations.html#setter_name) _可選_ [*代碼塊*](..\chapter3\05_Declarations.html#code_block) + + + +> 類型別名聲明語法 +> *類型別名聲明* → [*類型別名頭(Head)*](..\chapter3\05_Declarations.html#typealias_head) [*類型別名賦值*](..\chapter3\05_Declarations.html#typealias_assignment) +> *類型別名頭(Head)* → **typealias** [*類型別名名稱*](..\chapter3\05_Declarations.html#typealias_name) +> *類型別名名稱* → [*標識符*](..\chapter3\02_Lexical_Structure.html#identifier) +> *類型別名賦值* → **=** [*類型*](..\chapter3\03_Types.html#type) + + + +> 函數聲明語法 +> *函數聲明* → [*函數頭*](..\chapter3\05_Declarations.html#function_head) [*函數名*](..\chapter3\05_Declarations.html#function_name) [*泛型參數子句*](GenericParametersAndArguments.html#generic_parameter_clause) _可選_ [*函數簽名(Signature)*](..\chapter3\05_Declarations.html#function_signature) [*函數體*](..\chapter3\05_Declarations.html#function_body) +> *函數頭* → [*特性(Attributes)列表*](..\chapter3\06_Attributes.html#attributes) _可選_ [*聲明描述符(Specifiers)列表*](..\chapter3\05_Declarations.html#declaration_specifiers) _可選_ **func** +> *函數名* → [*標識符*](..\chapter3\02_Lexical_Structure.html#identifier) | [*運算符*](..\chapter3\02_Lexical_Structure.html#operator) +> *函數簽名(Signature)* → [*parameter-clauses*](..\chapter3\05_Declarations.html#parameter_clauses) [*函數結果*](..\chapter3\05_Declarations.html#function_result) _可選_ +> *函數結果* → **->** [*特性(Attributes)列表*](..\chapter3\06_Attributes.html#attributes) _可選_ [*類型*](..\chapter3\03_Types.html#type) +> *函數體* → [*代碼塊*](..\chapter3\05_Declarations.html#code_block) +> *parameter-clauses* → [*參數子句*](..\chapter3\05_Declarations.html#parameter_clause) [*parameter-clauses*](..\chapter3\05_Declarations.html#parameter_clauses) _可選_ +> *參數子句* → **(** **)** | **(** [*參數列表*](..\chapter3\05_Declarations.html#parameter_list) **...** _可選_ **)** +> *參數列表* → [*參數*](..\chapter3\05_Declarations.html#parameter) | [*參數*](..\chapter3\05_Declarations.html#parameter) **,** [*參數列表*](..\chapter3\05_Declarations.html#parameter_list) +> *參數* → **inout** _可選_ **let** _可選_ **#** _可選_ [*參數名*](..\chapter3\05_Declarations.html#parameter_name) [*本地參數名*](..\chapter3\05_Declarations.html#local_parameter_name) _可選_ [*類型註解*](..\chapter3\03_Types.html#type_annotation) [*默認參數子句*](..\chapter3\05_Declarations.html#default_argument_clause) _可選_ +> *參數* → **inout** _可選_ **var** **#** _可選_ [*參數名*](..\chapter3\05_Declarations.html#parameter_name) [*本地參數名*](..\chapter3\05_Declarations.html#local_parameter_name) _可選_ [*類型註解*](..\chapter3\03_Types.html#type_annotation) [*默認參數子句*](..\chapter3\05_Declarations.html#default_argument_clause) _可選_ +> *參數* → [*特性(Attributes)列表*](..\chapter3\06_Attributes.html#attributes) _可選_ [*類型*](..\chapter3\03_Types.html#type) +> *參數名* → [*標識符*](..\chapter3\02_Lexical_Structure.html#identifier) | **_** +> *本地參數名* → [*標識符*](..\chapter3\02_Lexical_Structure.html#identifier) | **_** +> *默認參數子句* → **=** [*表達式*](..\chapter3\04_Expressions.html#expression) + + + +> 枚舉聲明語法 +> *枚舉聲明* → [*特性(Attributes)列表*](..\chapter3\06_Attributes.html#attributes) _可選_ [*聯合式枚舉*](..\chapter3\05_Declarations.html#union_style_enum) | [*特性(Attributes)列表*](..\chapter3\06_Attributes.html#attributes) _可選_ [*原始值式枚舉*](..\chapter3\05_Declarations.html#raw_value_style_enum) +> *聯合式枚舉* → [*枚舉名*](..\chapter3\05_Declarations.html#enum_name) [*泛型參數子句*](GenericParametersAndArguments.html#generic_parameter_clause) _可選_ **{** [*union-style-enum-members*](..\chapter3\05_Declarations.html#union_style_enum_members) _可選_ **}** +> *union-style-enum-members* → [*union-style-enum-member*](..\chapter3\05_Declarations.html#union_style_enum_member) [*union-style-enum-members*](..\chapter3\05_Declarations.html#union_style_enum_members) _可選_ +> *union-style-enum-member* → [*聲明*](..\chapter3\05_Declarations.html#declaration) | [*聯合式(Union Style)的枚舉case子句*](..\chapter3\05_Declarations.html#union_style_enum_case_clause) +> *聯合式(Union Style)的枚舉case子句* → [*特性(Attributes)列表*](..\chapter3\06_Attributes.html#attributes) _可選_ **case** [*聯合式(Union Style)的枚舉case列表*](..\chapter3\05_Declarations.html#union_style_enum_case_list) +> *聯合式(Union Style)的枚舉case列表* → [*聯合式(Union Style)的case*](..\chapter3\05_Declarations.html#union_style_enum_case) | [*聯合式(Union Style)的case*](..\chapter3\05_Declarations.html#union_style_enum_case) **,** [*聯合式(Union Style)的枚舉case列表*](..\chapter3\05_Declarations.html#union_style_enum_case_list) +> *聯合式(Union Style)的case* → [*枚舉的case名*](..\chapter3\05_Declarations.html#enum_case_name) [*元組類型*](..\chapter3\03_Types.html#tuple_type) _可選_ +> *枚舉名* → [*標識符*](..\chapter3\02_Lexical_Structure.html#identifier) +> *枚舉的case名* → [*標識符*](..\chapter3\02_Lexical_Structure.html#identifier) +> *原始值式枚舉* → [*枚舉名*](..\chapter3\05_Declarations.html#enum_name) [*泛型參數子句*](GenericParametersAndArguments.html#generic_parameter_clause) _可選_ **:** [*類型標識*](..\chapter3\03_Types.html#type_identifier) **{** [*原始值式枚舉成員列表*](..\chapter3\05_Declarations.html#raw_value_style_enum_members) _可選_ **}** +> *原始值式枚舉成員列表* → [*原始值式枚舉成員*](..\chapter3\05_Declarations.html#raw_value_style_enum_member) [*原始值式枚舉成員列表*](..\chapter3\05_Declarations.html#raw_value_style_enum_members) _可選_ +> *原始值式枚舉成員* → [*聲明*](..\chapter3\05_Declarations.html#declaration) | [*原始值式枚舉case子句*](..\chapter3\05_Declarations.html#raw_value_style_enum_case_clause) +> *原始值式枚舉case子句* → [*特性(Attributes)列表*](..\chapter3\06_Attributes.html#attributes) _可選_ **case** [*原始值式枚舉case列表*](..\chapter3\05_Declarations.html#raw_value_style_enum_case_list) +> *原始值式枚舉case列表* → [*原始值式枚舉case*](..\chapter3\05_Declarations.html#raw_value_style_enum_case) | [*原始值式枚舉case*](..\chapter3\05_Declarations.html#raw_value_style_enum_case) **,** [*原始值式枚舉case列表*](..\chapter3\05_Declarations.html#raw_value_style_enum_case_list) +> *原始值式枚舉case* → [*枚舉的case名*](..\chapter3\05_Declarations.html#enum_case_name) [*原始值賦值*](..\chapter3\05_Declarations.html#raw_value_assignment) _可選_ +> *原始值賦值* → **=** [*字面量*](..\chapter3\02_Lexical_Structure.html#literal) + + + +> 結構體聲明語法 +> *結構體聲明* → [*特性(Attributes)列表*](..\chapter3\06_Attributes.html#attributes) _可選_ **struct** [*結構體名稱*](..\chapter3\05_Declarations.html#struct_name) [*泛型參數子句*](GenericParametersAndArguments.html#generic_parameter_clause) _可選_ [*類型繼承子句*](..\chapter3\03_Types.html#type_inheritance_clause) _可選_ [*結構體主體*](..\chapter3\05_Declarations.html#struct_body) +> *結構體名稱* → [*標識符*](..\chapter3\02_Lexical_Structure.html#identifier) +> *結構體主體* → **{** [*聲明(Declarations)列表*](..\chapter3\05_Declarations.html#declarations) _可選_ **}** + + + +> 類聲明語法 +> *類聲明* → [*特性(Attributes)列表*](..\chapter3\06_Attributes.html#attributes) _可選_ **class** [*類名*](..\chapter3\05_Declarations.html#class_name) [*泛型參數子句*](GenericParametersAndArguments.html#generic_parameter_clause) _可選_ [*類型繼承子句*](..\chapter3\03_Types.html#type_inheritance_clause) _可選_ [*類主體*](..\chapter3\05_Declarations.html#class_body) +> *類名* → [*標識符*](..\chapter3\02_Lexical_Structure.html#identifier) +> *類主體* → **{** [*聲明(Declarations)列表*](..\chapter3\05_Declarations.html#declarations) _可選_ **}** + + + +> 協議(Protocol)聲明語法 +> *協議聲明* → [*特性(Attributes)列表*](..\chapter3\06_Attributes.html#attributes) _可選_ **protocol** [*協議名*](..\chapter3\05_Declarations.html#protocol_name) [*類型繼承子句*](..\chapter3\03_Types.html#type_inheritance_clause) _可選_ [*協議主體*](..\chapter3\05_Declarations.html#protocol_body) +> *協議名* → [*標識符*](..\chapter3\02_Lexical_Structure.html#identifier) +> *協議主體* → **{** [*協議成員聲明(Declarations)列表*](..\chapter3\05_Declarations.html#protocol_member_declarations) _可選_ **}** +> *協議成員聲明* → [*協議屬性聲明*](..\chapter3\05_Declarations.html#protocol_property_declaration) +> *協議成員聲明* → [*協議方法聲明*](..\chapter3\05_Declarations.html#protocol_method_declaration) +> *協議成員聲明* → [*協議構造器聲明*](..\chapter3\05_Declarations.html#protocol_initializer_declaration) +> *協議成員聲明* → [*協議下標腳本聲明*](..\chapter3\05_Declarations.html#protocol_subscript_declaration) +> *協議成員聲明* → [*協議關聯類型聲明*](..\chapter3\05_Declarations.html#protocol_associated_type_declaration) +> *協議成員聲明(Declarations)列表* → [*協議成員聲明*](..\chapter3\05_Declarations.html#protocol_member_declaration) [*協議成員聲明(Declarations)列表*](..\chapter3\05_Declarations.html#protocol_member_declarations) _可選_ + + + +> 協議屬性聲明語法 +> *協議屬性聲明* → [*變量聲明頭(Head)*](..\chapter3\05_Declarations.html#variable_declaration_head) [*變量名*](..\chapter3\05_Declarations.html#variable_name) [*類型註解*](..\chapter3\03_Types.html#type_annotation) [*getter-setter關鍵字(Keyword)塊*](..\chapter3\05_Declarations.html#getter_setter_keyword_block) + + + +> 協議方法聲明語法 +> *協議方法聲明* → [*函數頭*](..\chapter3\05_Declarations.html#function_head) [*函數名*](..\chapter3\05_Declarations.html#function_name) [*泛型參數子句*](GenericParametersAndArguments.html#generic_parameter_clause) _可選_ [*函數簽名(Signature)*](..\chapter3\05_Declarations.html#function_signature) + + + +> 協議構造器聲明語法 +> *協議構造器聲明* → [*構造器頭(Head)*](..\chapter3\05_Declarations.html#initializer_head) [*泛型參數子句*](GenericParametersAndArguments.html#generic_parameter_clause) _可選_ [*參數子句*](..\chapter3\05_Declarations.html#parameter_clause) + + + +> 協議下標腳本聲明語法 +> *協議下標腳本聲明* → [*下標腳本頭(Head)*](..\chapter3\05_Declarations.html#subscript_head) [*下標腳本結果(Result)*](..\chapter3\05_Declarations.html#subscript_result) [*getter-setter關鍵字(Keyword)塊*](..\chapter3\05_Declarations.html#getter_setter_keyword_block) + + + +> 協議關聯類型聲明語法 +> *協議關聯類型聲明* → [*類型別名頭(Head)*](..\chapter3\05_Declarations.html#typealias_head) [*類型繼承子句*](..\chapter3\03_Types.html#type_inheritance_clause) _可選_ [*類型別名賦值*](..\chapter3\05_Declarations.html#typealias_assignment) _可選_ + + + +> 構造器聲明語法 +> *構造器聲明* → [*構造器頭(Head)*](..\chapter3\05_Declarations.html#initializer_head) [*泛型參數子句*](GenericParametersAndArguments.html#generic_parameter_clause) _可選_ [*參數子句*](..\chapter3\05_Declarations.html#parameter_clause) [*構造器主體*](..\chapter3\05_Declarations.html#initializer_body) +> *構造器頭(Head)* → [*特性(Attributes)列表*](..\chapter3\06_Attributes.html#attributes) _可選_ **convenience** _可選_ **init** +> *構造器主體* → [*代碼塊*](..\chapter3\05_Declarations.html#code_block) + + + +> 析構器聲明語法 +> *析構器聲明* → [*特性(Attributes)列表*](..\chapter3\06_Attributes.html#attributes) _可選_ **deinit** [*代碼塊*](..\chapter3\05_Declarations.html#code_block) + + + +> 擴展(Extension)聲明語法 +> *擴展聲明* → **extension** [*類型標識*](..\chapter3\03_Types.html#type_identifier) [*類型繼承子句*](..\chapter3\03_Types.html#type_inheritance_clause) _可選_ [*extension-body*](..\chapter3\05_Declarations.html#extension_body) +> *extension-body* → **{** [*聲明(Declarations)列表*](..\chapter3\05_Declarations.html#declarations) _可選_ **}** + + + +> 下標腳本聲明語法 +> *下標腳本聲明* → [*下標腳本頭(Head)*](..\chapter3\05_Declarations.html#subscript_head) [*下標腳本結果(Result)*](..\chapter3\05_Declarations.html#subscript_result) [*代碼塊*](..\chapter3\05_Declarations.html#code_block) +> *下標腳本聲明* → [*下標腳本頭(Head)*](..\chapter3\05_Declarations.html#subscript_head) [*下標腳本結果(Result)*](..\chapter3\05_Declarations.html#subscript_result) [*getter-setter塊*](..\chapter3\05_Declarations.html#getter_setter_block) +> *下標腳本聲明* → [*下標腳本頭(Head)*](..\chapter3\05_Declarations.html#subscript_head) [*下標腳本結果(Result)*](..\chapter3\05_Declarations.html#subscript_result) [*getter-setter關鍵字(Keyword)塊*](..\chapter3\05_Declarations.html#getter_setter_keyword_block) +> *下標腳本頭(Head)* → [*特性(Attributes)列表*](..\chapter3\06_Attributes.html#attributes) _可選_ **subscript** [*參數子句*](..\chapter3\05_Declarations.html#parameter_clause) +> *下標腳本結果(Result)* → **->** [*特性(Attributes)列表*](..\chapter3\06_Attributes.html#attributes) _可選_ [*類型*](..\chapter3\03_Types.html#type) + + + +> 運算符聲明語法 +> *運算符聲明* → [*前置運算符聲明*](..\chapter3\05_Declarations.html#prefix_operator_declaration) | [*後置運算符聲明*](..\chapter3\05_Declarations.html#postfix_operator_declaration) | [*中置運算符聲明*](..\chapter3\05_Declarations.html#infix_operator_declaration) +> *前置運算符聲明* → **運算符** **prefix** [*運算符*](..\chapter3\02_Lexical_Structure.html#operator) **{** **}** +> *後置運算符聲明* → **運算符** **postfix** [*運算符*](..\chapter3\02_Lexical_Structure.html#operator) **{** **}** +> *中置運算符聲明* → **運算符** **infix** [*運算符*](..\chapter3\02_Lexical_Structure.html#operator) **{** [*中置運算符屬性*](..\chapter3\05_Declarations.html#infix_operator_attributes) _可選_ **}** +> *中置運算符屬性* → [*優先級子句*](..\chapter3\05_Declarations.html#precedence_clause) _可選_ [*結和性子句*](..\chapter3\05_Declarations.html#associativity_clause) _可選_ +> *優先級子句* → **precedence** [*優先級水平*](..\chapter3\05_Declarations.html#precedence_level) +> *優先級水平* → 數值 0 到 255 +> *結和性子句* → **associativity** [*結和性*](..\chapter3\05_Declarations.html#associativity) +> *結和性* → **left** | **right** | **none** + + +## 模式 + +> 模式(Patterns) 語法 +> *模式* → [*通配符模式*](..\chapter3\07_Patterns.html#wildcard_pattern) [*類型註解*](..\chapter3\03_Types.html#type_annotation) _可選_ +> *模式* → [*標識符模式*](..\chapter3\07_Patterns.html#identifier_pattern) [*類型註解*](..\chapter3\03_Types.html#type_annotati(Value Binding)on) _可選_ +> *模式* → [*值綁定模式*](..\chapter3\07_Patterns.html#value_binding_pattern) +> *模式* → [*元組模式*](..\chapter3\07_Patterns.html#tuple_pattern) [*類型註解*](..\chapter3\03_Types.html#type_annotation) _可選_ +> *模式* → [*enum-case-pattern*](..\chapter3\07_Patterns.html#enum_case_pattern) +> *模式* → [*type-casting-pattern*](..\chapter3\07_Patterns.html#type_casting_pattern) +> *模式* → [*表達式模式*](..\chapter3\07_Patterns.html#expression_pattern) + + + +> 通配符模式語法 +> *通配符模式* → **_** + + + +> 標識符模式語法 +> *標識符模式* → [*標識符*](..\chapter3\02_Lexical_Structure.html#identifier) + + + +> 值綁定(Value Binding)模式語法 +> *值綁定模式* → **var** [*模式*](..\chapter3\07_Patterns.html#pattern) | **let** [*模式*](..\chapter3\07_Patterns.html#pattern) + + + +> 元組模式語法 +> *元組模式* → **(** [*元組模式元素列表*](..\chapter3\07_Patterns.html#tuple_pattern_element_list) _可選_ **)** +> *元組模式元素列表* → [*元組模式元素*](..\chapter3\07_Patterns.html#tuple_pattern_element) | [*元組模式元素*](..\chapter3\07_Patterns.html#tuple_pattern_element) **,** [*元組模式元素列表*](..\chapter3\07_Patterns.html#tuple_pattern_element_list) +> *元組模式元素* → [*模式*](..\chapter3\07_Patterns.html#pattern) + + + +> 枚舉用例模式語法 +> *enum-case-pattern* → [*類型標識*](..\chapter3\03_Types.html#type_identifier) _可選_ **.** [*枚舉的case名*](..\chapter3\05_Declarations.html#enum_case_name) [*元組模式*](..\chapter3\07_Patterns.html#tuple_pattern) _可選_ + + + +> 類型轉換模式語法 +> *type-casting-pattern* → [*is模式*](..\chapter3\07_Patterns.html#is_pattern) | [*as模式*](..\chapter3\07_Patterns.html#as_pattern) +> *is模式* → **is** [*類型*](..\chapter3\03_Types.html#type) +> *as模式* → [*模式*](..\chapter3\07_Patterns.html#pattern) **as** [*類型*](..\chapter3\03_Types.html#type) + + + +> 表達式模式語法 +> *表達式模式* → [*表達式*](..\chapter3\04_Expressions.html#expression) + + +## 特性 + +> 特性語法 +> *特色* → **@** [*特性名*](..\chapter3\06_Attributes.html#attribute_name) [*特性參數子句*](..\chapter3\06_Attributes.html#attribute_argument_clause) _可選_ +> *特性名* → [*標識符*](..\chapter3\02_Lexical_Structure.html#identifier) +> *特性參數子句* → **(** [*平衡令牌列表*](..\chapter3\06_Attributes.html#balanced_tokens) _可選_ **)** +> *特性(Attributes)列表* → [*特色*](..\chapter3\06_Attributes.html#attribute) [*特性(Attributes)列表*](..\chapter3\06_Attributes.html#attributes) _可選_ +> *平衡令牌列表* → [*平衡令牌*](..\chapter3\06_Attributes.html#balanced_token) [*平衡令牌列表*](..\chapter3\06_Attributes.html#balanced_tokens) _可選_ +> *平衡令牌* → **(** [*平衡令牌列表*](..\chapter3\06_Attributes.html#balanced_tokens) _可選_ **)** +> *平衡令牌* → **[** [*平衡令牌列表*](..\chapter3\06_Attributes.html#balanced_tokens) _可選_ **]** +> *平衡令牌* → **{** [*平衡令牌列表*](..\chapter3\06_Attributes.html#balanced_tokens) _可選_ **}** +> *平衡令牌* → **任意標識符, 關鍵字, 字面量或運算符** +> *平衡令牌* → **任意標點除了(, ), [, ], {, 或 }** + + +## 表達式 + +> 表達式語法 +> *表達式* → [*前置表達式*](..\chapter3\04_Expressions.html#prefix_expression) [*二元表達式列表*](..\chapter3\04_Expressions.html#binary_expressions) _可選_ +> *表達式列表* → [*表達式*](..\chapter3\04_Expressions.html#expression) | [*表達式*](..\chapter3\04_Expressions.html#expression) **,** [*表達式列表*](..\chapter3\04_Expressions.html#expression_list) + + + +> 前置表達式語法 +> *前置表達式* → [*前置運算符*](..\chapter3\02_Lexical_Structure.html#prefix_operator) _可選_ [*後置表達式*](..\chapter3\04_Expressions.html#postfix_expression) +> *前置表達式* → [*寫入寫出(in-out)表達式*](..\chapter3\04_Expressions.html#in_out_expression) +> *寫入寫出(in-out)表達式* → **&** [*標識符*](..\chapter3\02_Lexical_Structure.html#identifier) + + + +> 二元表達式語法 +> *二元表達式* → [*二元運算符*](..\chapter3\02_Lexical_Structure.html#binary_operator) [*前置表達式*](..\chapter3\04_Expressions.html#prefix_expression) +> *二元表達式* → [*賦值運算符*](..\chapter3\04_Expressions.html#assignment_operator) [*前置表達式*](..\chapter3\04_Expressions.html#prefix_expression) +> *二元表達式* → [*條件運算符*](..\chapter3\04_Expressions.html#conditional_operator) [*前置表達式*](..\chapter3\04_Expressions.html#prefix_expression) +> *二元表達式* → [*類型轉換運算符*](..\chapter3\04_Expressions.html#type_casting_operator) +> *二元表達式列表* → [*二元表達式*](..\chapter3\04_Expressions.html#binary_expression) [*二元表達式列表*](..\chapter3\04_Expressions.html#binary_expressions) _可選_ + + + +> 賦值運算符語法 +> *賦值運算符* → **=** + + + +> 三元條件運算符語法 +> *三元條件運算符* → **?** [*表達式*](..\chapter3\04_Expressions.html#expression) **:** + + + +> 類型轉換運算符語法 +> *類型轉換運算符* → **is** [*類型*](..\chapter3\03_Types.html#type) | **as** **?** _可選_ [*類型*](..\chapter3\03_Types.html#type) + + + +> 主表達式語法 +> *主表達式* → [*標識符*](..\chapter3\02_Lexical_Structure.html#identifier) [*泛型參數子句*](GenericParametersAndArguments.html#generic_argument_clause) _可選_ +> *主表達式* → [*字面量表達式*](..\chapter3\04_Expressions.html#literal_expression) +> *主表達式* → [*self表達式*](..\chapter3\04_Expressions.html#self_expression) +> *主表達式* → [*超類表達式*](..\chapter3\04_Expressions.html#superclass_expression) +> *主表達式* → [*閉包表達式*](..\chapter3\04_Expressions.html#closure_expression) +> *主表達式* → [*圓括號表達式*](..\chapter3\04_Expressions.html#parenthesized_expression) +> *主表達式* → [*隱式成員表達式*](..\chapter3\04_Expressions.html#implicit_member_expression) +> *主表達式* → [*通配符表達式*](..\chapter3\04_Expressions.html#wildcard_expression) + + + +> 字面量表達式語法 +> *字面量表達式* → [*字面量*](..\chapter3\02_Lexical_Structure.html#literal) +> *字面量表達式* → [*數組字面量*](..\chapter3\04_Expressions.html#array_literal) | [*字典字面量*](..\chapter3\04_Expressions.html#dictionary_literal) +> *字面量表達式* → **__FILE__** | **__LINE__** | **__COLUMN__** | **__FUNCTION__** +> *數組字面量* → **[** [*數組字面量項列表*](..\chapter3\04_Expressions.html#array_literal_items) _可選_ **]** +> *數組字面量項列表* → [*數組字面量項*](..\chapter3\04_Expressions.html#array_literal_item) **,** _可選_ | [*數組字面量項*](..\chapter3\04_Expressions.html#array_literal_item) **,** [*數組字面量項列表*](..\chapter3\04_Expressions.html#array_literal_items) +> *數組字面量項* → [*表達式*](..\chapter3\04_Expressions.html#expression) +> *字典字面量* → **[** [*字典字面量項列表*](..\chapter3\04_Expressions.html#dictionary_literal_items) **]** | **[** **:** **]** +> *字典字面量項列表* → [*字典字面量項*](..\chapter3\04_Expressions.html#dictionary_literal_item) **,** _可選_ | [*字典字面量項*](..\chapter3\04_Expressions.html#dictionary_literal_item) **,** [*字典字面量項列表*](..\chapter3\04_Expressions.html#dictionary_literal_items) +> *字典字面量項* → [*表達式*](..\chapter3\04_Expressions.html#expression) **:** [*表達式*](..\chapter3\04_Expressions.html#expression) + + + +> Self 表達式語法 +> *self表達式* → **self** +> *self表達式* → **self** **.** [*標識符*](..\chapter3\02_Lexical_Structure.html#identifier) +> *self表達式* → **self** **[** [*表達式*](..\chapter3\04_Expressions.html#expression) **]** +> *self表達式* → **self** **.** **init** + + + +> 超類表達式語法 +> *超類表達式* → [*超類方法表達式*](..\chapter3\04_Expressions.html#superclass_method_expression) | [*超類下標表達式*](..\chapter3\04_Expressions.html#超類下標表達式) | [*超類構造器表達式*](..\chapter3\04_Expressions.html#superclass_initializer_expression) +> *超類方法表達式* → **super** **.** [*標識符*](..\chapter3\02_Lexical_Structure.html#identifier) +> *超類下標表達式* → **super** **[** [*表達式*](..\chapter3\04_Expressions.html#expression) **]** +> *超類構造器表達式* → **super** **.** **init** + + + +> 閉包表達式語法 +> *閉包表達式* → **{** [*閉包簽名(Signational)*](..\chapter3\04_Expressions.html#closure_signature) _可選_ [*多條語句(Statements)*](..\chapter3\10_Statements.html#statements) **}** +> *閉包簽名(Signational)* → [*參數子句*](..\chapter3\05_Declarations.html#parameter_clause) [*函數結果*](..\chapter3\05_Declarations.html#function_result) _可選_ **in** +> *閉包簽名(Signational)* → [*標識符列表*](..\chapter3\02_Lexical_Structure.html#identifier_list) [*函數結果*](..\chapter3\05_Declarations.html#function_result) _可選_ **in** +> *閉包簽名(Signational)* → [*捕獲(Capature)列表*](..\chapter3\04_Expressions.html#capture_list) [*參數子句*](..\chapter3\05_Declarations.html#parameter_clause) [*函數結果*](..\chapter3\05_Declarations.html#function_result) _可選_ **in** +> *閉包簽名(Signational)* → [*捕獲(Capature)列表*](..\chapter3\04_Expressions.html#capture_list) [*標識符列表*](..\chapter3\02_Lexical_Structure.html#identifier_list) [*函數結果*](..\chapter3\05_Declarations.html#function_result) _可選_ **in** +> *閉包簽名(Signational)* → [*捕獲(Capature)列表*](..\chapter3\04_Expressions.html#capture_list) **in** +> *捕獲(Capature)列表* → **[** [*捕獲(Capature)說明符*](..\chapter3\04_Expressions.html#capture_specifier) [*表達式*](..\chapter3\04_Expressions.html#expression) **]** +> *捕獲(Capature)說明符* → **weak** | **unowned** | **unowned(safe)** | **unowned(unsafe)** + + + +> 隱式成員表達式語法 +> *隱式成員表達式* → **.** [*標識符*](..\chapter3\02_Lexical_Structure.html#identifier) + + + +> 圓括號表達式(Parenthesized Expression)語法 +> *圓括號表達式* → **(** [*表達式元素列表*](..\chapter3\04_Expressions.html#expression_element_list) _可選_ **)** +> *表達式元素列表* → [*表達式元素*](..\chapter3\04_Expressions.html#expression_element) | [*表達式元素*](..\chapter3\04_Expressions.html#expression_element) **,** [*表達式元素列表*](..\chapter3\04_Expressions.html#expression_element_list) +> *表達式元素* → [*表達式*](..\chapter3\04_Expressions.html#expression) | [*標識符*](..\chapter3\02_Lexical_Structure.html#identifier) **:** [*表達式*](..\chapter3\04_Expressions.html#expression) + + + +> 通配符表達式語法 +> *通配符表達式* → **_** + + + +> 後置表達式語法 +> *後置表達式* → [*主表達式*](..\chapter3\04_Expressions.html#primary_expression) +> *後置表達式* → [*後置表達式*](..\chapter3\04_Expressions.html#postfix_expression) [*後置運算符*](..\chapter3\02_Lexical_Structure.html#postfix_operator) +> *後置表達式* → [*函數調用表達式*](..\chapter3\04_Expressions.html#function_call_expression) +> *後置表達式* → [*構造器表達式*](..\chapter3\04_Expressions.html#initializer_expression) +> *後置表達式* → [*顯示成員表達式*](..\chapter3\04_Expressions.html#explicit_member_expression) +> *後置表達式* → [*後置self表達式*](..\chapter3\04_Expressions.html#postfix_self_expression) +> *後置表達式* → [*動態類型表達式*](..\chapter3\04_Expressions.html#dynamic_type_expression) +> *後置表達式* → [*下標表達式*](..\chapter3\04_Expressions.html#subscript_expression) +> *後置表達式* → [*強制取值(Forced Value)表達式*](..\chapter3\04_Expressions.html#forced_value_expression) +> *後置表達式* → [*可選鏈(Optional Chaining)表達式*](..\chapter3\04_Expressions.html#optional_chaining_expression) + + + +> 函數調用表達式語法 +> *函數調用表達式* → [*後置表達式*](..\chapter3\04_Expressions.html#postfix_expression) [*圓括號表達式*](..\chapter3\04_Expressions.html#parenthesized_expression) +> *函數調用表達式* → [*後置表達式*](..\chapter3\04_Expressions.html#postfix_expression) [*圓括號表達式*](..\chapter3\04_Expressions.html#parenthesized_expression) _可選_ [*後置閉包(Trailing Closure)*](..\chapter3\04_Expressions.html#trailing_closure) +> *後置閉包(Trailing Closure)* → [*閉包表達式*](..\chapter3\04_Expressions.html#closure_expression) + + + +> 構造器表達式語法 +> *構造器表達式* → [*後置表達式*](..\chapter3\04_Expressions.html#postfix_expression) **.** **init** + + + +> 顯式成員表達式語法 +> *顯示成員表達式* → [*後置表達式*](..\chapter3\04_Expressions.html#postfix_expression) **.** [*十進制數字*](..\chapter3\02_Lexical_Structure.html#decimal_digit) +> *顯示成員表達式* → [*後置表達式*](..\chapter3\04_Expressions.html#postfix_expression) **.** [*標識符*](..\chapter3\02_Lexical_Structure.html#identifier) [*泛型參數子句*](GenericParametersAndArguments.html#generic_argument_clause) _可選_ + + + +> 後置Self 表達式語法 +> *後置self表達式* → [*後置表達式*](..\chapter3\04_Expressions.html#postfix_expression) **.** **self** + + + +> 動態類型表達式語法 +> *動態類型表達式* → [*後置表達式*](..\chapter3\04_Expressions.html#postfix_expression) **.** **dynamicType** + + + +> 附屬腳本表達式語法 +> *附屬腳本表達式* → [*後置表達式*](..\chapter3\04_Expressions.html#postfix_expression) **[** [*表達式列表*](..\chapter3\04_Expressions.html#expression_list) **]** + + + +> 強制取值(Forced Value)語法 +> *強制取值(Forced Value)表達式* → [*後置表達式*](..\chapter3\04_Expressions.html#postfix_expression) **!** + + + +> 可選鏈表達式語法 +> *可選鏈表達式* → [*後置表達式*](..\chapter3\04_Expressions.html#postfix_expression) **?** + + +## 詞法結構 + +> 標識符語法 +> *標識符* → [*標識符頭(Head)*](..\chapter3\02_Lexical_Structure.html#identifier_head) [*標識符字符列表*](..\chapter3\02_Lexical_Structure.html#identifier_characters) _可選_ +> *標識符* → **`** [*標識符頭(Head)*](..\chapter3\02_Lexical_Structure.html#identifier_head) [*標識符字符列表*](..\chapter3\02_Lexical_Structure.html#identifier_characters) _可選_ **`** +> *標識符* → [*隱式參數名*](..\chapter3\02_Lexical_Structure.html#implicit_parameter_name) +> *標識符列表* → [*標識符*](..\chapter3\02_Lexical_Structure.html#identifier) | [*標識符*](..\chapter3\02_Lexical_Structure.html#identifier) **,** [*標識符列表*](..\chapter3\02_Lexical_Structure.html#identifier_list) +> *標識符頭(Head)* → Upper- or lowercase letter A through Z +> *標識符頭(Head)* → U+00A8, U+00AA, U+00AD, U+00AF, U+00B2–U+00B5, or U+00B7–U+00BA +> *標識符頭(Head)* → U+00BC–U+00BE, U+00C0–U+00D6, U+00D8–U+00F6, or U+00F8–U+00FF +> *標識符頭(Head)* → U+0100–U+02FF, U+0370–U+167F, U+1681–U+180D, or U+180F–U+1DBF +> *標識符頭(Head)* → U+1E00–U+1FFF +> *標識符頭(Head)* → U+200B–U+200D, U+202A–U+202E, U+203F–U+2040, U+2054, or U+2060–U+206F +> *標識符頭(Head)* → U+2070–U+20CF, U+2100–U+218F, U+2460–U+24FF, or U+2776–U+2793 +> *標識符頭(Head)* → U+2C00–U+2DFF or U+2E80–U+2FFF +> *標識符頭(Head)* → U+3004–U+3007, U+3021–U+302F, U+3031–U+303F, or U+3040–U+D7FF +> *標識符頭(Head)* → U+F900–U+FD3D, U+FD40–U+FDCF, U+FDF0–U+FE1F, or U+FE30–U+FE44 +> *標識符頭(Head)* → U+FE47–U+FFFD +> *標識符頭(Head)* → U+10000–U+1FFFD, U+20000–U+2FFFD, U+30000–U+3FFFD, or U+40000–U+4FFFD +> *標識符頭(Head)* → U+50000–U+5FFFD, U+60000–U+6FFFD, U+70000–U+7FFFD, or U+80000–U+8FFFD +> *標識符頭(Head)* → U+90000–U+9FFFD, U+A0000–U+AFFFD, U+B0000–U+BFFFD, or U+C0000–U+CFFFD +> *標識符頭(Head)* → U+D0000–U+DFFFD or U+E0000–U+EFFFD +> *標識符字符* → 數值 0 到 9 +> *標識符字符* → U+0300–U+036F, U+1DC0–U+1DFF, U+20D0–U+20FF, or U+FE20–U+FE2F +> *標識符字符* → [*標識符頭(Head)*](..\chapter3\02_Lexical_Structure.html#identifier_head) +> *標識符字符列表* → [*標識符字符*](..\chapter3\02_Lexical_Structure.html#identifier_character) [*標識符字符列表*](..\chapter3\02_Lexical_Structure.html#identifier_characters) _可選_ +> *隱式參數名* → **$** [*十進制數字列表*](..\chapter3\02_Lexical_Structure.html#decimal_digits) + + + +> 字面量語法 +> *字面量* → [*整型字面量*](..\chapter3\02_Lexical_Structure.html#integer_literal) | [*浮點數字面量*](..\chapter3\02_Lexical_Structure.html#floating_point_literal) | [*字符串字面量*](..\chapter3\02_Lexical_Structure.html#string_literal) + + + +> 整型字面量語法 +> *整型字面量* → [*二進制字面量*](..\chapter3\02_Lexical_Structure.html#binary_literal) +> *整型字面量* → [*八進制字面量*](..\chapter3\02_Lexical_Structure.html#octal_literal) +> *整型字面量* → [*十進制字面量*](..\chapter3\02_Lexical_Structure.html#decimal_literal) +> *整型字面量* → [*十六進制字面量*](..\chapter3\02_Lexical_Structure.html#hexadecimal_literal) +> *二進制字面量* → **0b** [*二進制數字*](..\chapter3\02_Lexical_Structure.html#binary_digit) [*二進制字面量字符列表*](..\chapter3\02_Lexical_Structure.html#binary_literal_characters) _可選_ +> *二進制數字* → 數值 0 到 1 +> *二進制字面量字符* → [*二進制數字*](..\chapter3\02_Lexical_Structure.html#binary_digit) | **_** +> *二進制字面量字符列表* → [*二進制字面量字符*](..\chapter3\02_Lexical_Structure.html#binary_literal_character) [*二進制字面量字符列表*](..\chapter3\02_Lexical_Structure.html#binary_literal_characters) _可選_ +> *八進制字面量* → **0o** [*八進字數字*](..\chapter3\02_Lexical_Structure.html#octal_digit) [*八進制字符列表*](..\chapter3\02_Lexical_Structure.html#octal_literal_characters) _可選_ +> *八進字數字* → 數值 0 到 7 +> *八進制字符* → [*八進字數字*](..\chapter3\02_Lexical_Structure.html#octal_digit) | **_** +> *八進制字符列表* → [*八進制字符*](..\chapter3\02_Lexical_Structure.html#octal_literal_character) [*八進制字符列表*](..\chapter3\02_Lexical_Structure.html#octal_literal_characters) _可選_ +> *十進制字面量* → [*十進制數字*](..\chapter3\02_Lexical_Structure.html#decimal_digit) [*十進制字符列表*](..\chapter3\02_Lexical_Structure.html#decimal_literal_characters) _可選_ +> *十進制數字* → 數值 0 到 9 +> *十進制數字列表* → [*十進制數字*](..\chapter3\02_Lexical_Structure.html#decimal_digit) [*十進制數字列表*](..\chapter3\02_Lexical_Structure.html#decimal_digits) _可選_ +> *十進制字符* → [*十進制數字*](..\chapter3\02_Lexical_Structure.html#decimal_digit) | **_** +> *十進制字符列表* → [*十進制字符*](..\chapter3\02_Lexical_Structure.html#decimal_literal_character) [*十進制字符列表*](..\chapter3\02_Lexical_Structure.html#decimal_literal_characters) _可選_ +> *十六進制字面量* → **0x** [*十六進制數字*](..\chapter3\02_Lexical_Structure.html#hexadecimal_digit) [*十六進制字面量字符列表*](..\chapter3\02_Lexical_Structure.html#hexadecimal_literal_characters) _可選_ +> *十六進制數字* → 數值 0 到 9, a through f, or A through F +> *十六進制字符* → [*十六進制數字*](..\chapter3\02_Lexical_Structure.html#hexadecimal_digit) | **_** +> *十六進制字面量字符列表* → [*十六進制字符*](..\chapter3\02_Lexical_Structure.html#hexadecimal_literal_character) [*十六進制字面量字符列表*](..\chapter3\02_Lexical_Structure.html#hexadecimal_literal_characters) _可選_ + + + +> 浮點型字面量語法 +> *浮點數字面量* → [*十進制字面量*](..\chapter3\02_Lexical_Structure.html#decimal_literal) [*十進制分數*](..\chapter3\02_Lexical_Structure.html#decimal_fraction) _可選_ [*十進制指數*](..\chapter3\02_Lexical_Structure.html#decimal_exponent) _可選_ +> *浮點數字面量* → [*十六進制字面量*](..\chapter3\02_Lexical_Structure.html#hexadecimal_literal) [*十六進制分數*](..\chapter3\02_Lexical_Structure.html#hexadecimal_fraction) _可選_ [*十六進制指數*](..\chapter3\02_Lexical_Structure.html#hexadecimal_exponent) +> *十進制分數* → **.** [*十進制字面量*](..\chapter3\02_Lexical_Structure.html#decimal_literal) +> *十進制指數* → [*浮點數e*](..\chapter3\02_Lexical_Structure.html#floating_point_e) [*正負號*](..\chapter3\02_Lexical_Structure.html#sign) _可選_ [*十進制字面量*](..\chapter3\02_Lexical_Structure.html#decimal_literal) +> *十六進制分數* → **.** [*十六進制字面量*](..\chapter3\02_Lexical_Structure.html#hexadecimal_literal) _可選_ +> *十六進制指數* → [*浮點數p*](..\chapter3\02_Lexical_Structure.html#floating_point_p) [*正負號*](..\chapter3\02_Lexical_Structure.html#sign) _可選_ [*十六進制字面量*](..\chapter3\02_Lexical_Structure.html#hexadecimal_literal) +> *浮點數e* → **e** | **E** +> *浮點數p* → **p** | **P** +> *正負號* → **+** | **-** + + + +> 字符型字面量語法 +> *字符串字面量* → **"** [*引用文本*](..\chapter3\02_Lexical_Structure.html#quoted_text) **"** +> *引用文本* → [*引用文本條目*](..\chapter3\02_Lexical_Structure.html#quoted_text_item) [*引用文本*](..\chapter3\02_Lexical_Structure.html#quoted_text) _可選_ +> *引用文本條目* → [*轉義字符*](..\chapter3\02_Lexical_Structure.html#escaped_character) +> *引用文本條目* → **\(** [*表達式*](..\chapter3\04_Expressions.html#expression) **)** +> *引用文本條目* → 除了"-, \-, U+000A, or U+000D的所有Unicode的字符 +> *轉義字符* → **\0** | **\\** | **\t** | **\n** | **\r** | **\"** | **\'** +> *轉義字符* → **\x** [*十六進制數字*](..\chapter3\02_Lexical_Structure.html#hexadecimal_digit) [*十六進制數字*](..\chapter3\02_Lexical_Structure.html#hexadecimal_digit) +> *轉義字符* → **\u** [*十六進制數字*](..\chapter3\02_Lexical_Structure.html#hexadecimal_digit) [*十六進制數字*](..\chapter3\02_Lexical_Structure.html#hexadecimal_digit) [*十六進制數字*](..\chapter3\02_Lexical_Structure.html#hexadecimal_digit) [*十六進制數字*](..\chapter3\02_Lexical_Structure.html#hexadecimal_digit) +> *轉義字符* → **\U** [*十六進制數字*](..\chapter3\02_Lexical_Structure.html#hexadecimal_digit) [*十六進制數字*](..\chapter3\02_Lexical_Structure.html#hexadecimal_digit) [*十六進制數字*](..\chapter3\02_Lexical_Structure.html#hexadecimal_digit) [*十六進制數字*](..\chapter3\02_Lexical_Structure.html#hexadecimal_digit) [*十六進制數字*](..\chapter3\02_Lexical_Structure.html#hexadecimal_digit) [*十六進制數字*](..\chapter3\02_Lexical_Structure.html#hexadecimal_digit) [*十六進制數字*](..\chapter3\02_Lexical_Structure.html#hexadecimal_digit) [*十六進制數字*](..\chapter3\02_Lexical_Structure.html#hexadecimal_digit) + + + +> 運算符語法語法 +> *運算符* → [*運算符字符*](..\chapter3\02_Lexical_Structure.html#operator_character) [*運算符*](..\chapter3\02_Lexical_Structure.html#operator) _可選_ +> *運算符字符* → **/** | **=** | **-** | **+** | **!** | ***** | **%** | **<** | **>** | **&** | **|** | **^** | **~** | **.** +> *二元運算符* → [*運算符*](..\chapter3\02_Lexical_Structure.html#operator) +> *前置運算符* → [*運算符*](..\chapter3\02_Lexical_Structure.html#operator) +> *後置運算符* → [*運算符*](..\chapter3\02_Lexical_Structure.html#operator) + + +## 類型 + +> 類型語法 +> *類型* → [*數組類型*](..\chapter3\03_Types.html#array_type) | [*函數類型*](..\chapter3\03_Types.html#function_type) | [*類型標識*](..\chapter3\03_Types.html#type_identifier) | [*元組類型*](..\chapter3\03_Types.html#tuple_type) | [*可選類型*](..\chapter3\03_Types.html#optional_type) | [*隱式解析可選類型*](..\chapter3\03_Types.html#implicitly_unwrapped_optional_type) | [*協議合成類型*](..\chapter3\03_Types.html#protocol_composition_type) | [*元型類型*](..\chapter3\03_Types.html#metatype_type) + + + +> 類型註解語法 +> *類型註解* → **:** [*特性(Attributes)列表*](..\chapter3\06_Attributes.html#attributes) _可選_ [*類型*](..\chapter3\03_Types.html#type) + + + +> 類型標識語法 +> *類型標識* → [*類型名稱*](..\chapter3\03_Types.html#type_name) [*泛型參數子句*](GenericParametersAndArguments.html#generic_argument_clause) _可選_ | [*類型名稱*](..\chapter3\03_Types.html#type_name) [*泛型參數子句*](GenericParametersAndArguments.html#generic_argument_clause) _可選_ **.** [*類型標識*](..\chapter3\03_Types.html#type_identifier) +> *類名* → [*標識符*](..\chapter3\02_Lexical_Structure.html#identifier) + + + +> 元組類型語法 +> *元組類型* → **(** [*元組類型主體*](..\chapter3\03_Types.html#tuple_type_body) _可選_ **)** +> *元組類型主體* → [*元組類型的元素列表*](..\chapter3\03_Types.html#tuple_type_element_list) **...** _可選_ +> *元組類型的元素列表* → [*元組類型的元素*](..\chapter3\03_Types.html#tuple_type_element) | [*元組類型的元素*](..\chapter3\03_Types.html#tuple_type_element) **,** [*元組類型的元素列表*](..\chapter3\03_Types.html#tuple_type_element_list) +> *元組類型的元素* → [*特性(Attributes)列表*](..\chapter3\06_Attributes.html#attributes) _可選_ **inout** _可選_ [*類型*](..\chapter3\03_Types.html#type) | **inout** _可選_ [*元素名*](..\chapter3\03_Types.html#element_name) [*類型註解*](..\chapter3\03_Types.html#type_annotation) +> *元素名* → [*標識符*](..\chapter3\02_Lexical_Structure.html#identifier) + + + +> 函數類型語法 +> *函數類型* → [*類型*](..\chapter3\03_Types.html#type) **->** [*類型*](..\chapter3\03_Types.html#type) + + + +> 數組類型語法 +> *數組類型* → [*類型*](..\chapter3\03_Types.html#type) **[** **]** | [*數組類型*](..\chapter3\03_Types.html#array_type) **[** **]** + + + +> 可選類型語法 +> *可選類型* → [*類型*](..\chapter3\03_Types.html#type) **?** + + + +> 隱式解析可選類型(Implicitly Unwrapped Optional Type)語法 +> *隱式解析可選類型* → [*類型*](..\chapter3\03_Types.html#type) **!** + + + +> 協議合成類型語法 +> *協議合成類型* → **protocol** **<** [*協議標識符列表*](..\chapter3\03_Types.html#protocol_identifier_list) _可選_ **>** +> *協議標識符列表* → [*協議標識符*](..\chapter3\03_Types.html#protocol_identifier) | [*協議標識符*](..\chapter3\03_Types.html#protocol_identifier) **,** [*協議標識符列表*](..\chapter3\03_Types.html#protocol_identifier_list) +> *協議標識符* → [*類型標識*](..\chapter3\03_Types.html#type_identifier) + + + +> 元(Metatype)類型語法 +> *元類型* → [*類型*](..\chapter3\03_Types.html#type) **.** **Type** | [*類型*](..\chapter3\03_Types.html#type) **.** **Protocol** + + + +> 類型繼承子句語法 +> *類型繼承子句* → **:** [*類型繼承列表*](..\chapter3\03_Types.html#type_inheritance_list) +> *類型繼承列表* → [*類型標識*](..\chapter3\03_Types.html#type_identifier) | [*類型標識*](..\chapter3\03_Types.html#type_identifier) **,** [*類型繼承列表*](..\chapter3\03_Types.html#type_inheritance_list) diff --git a/source-tw/chapter3/10_Statements.md b/source-tw/chapter3/10_Statements.md new file mode 100644 index 00000000..f5413f4a --- /dev/null +++ b/source-tw/chapter3/10_Statements.md @@ -0,0 +1,322 @@ +> 翻譯：[coverxit](https://github.com/coverxit) +> 校對：[numbbbbb](https://github.com/numbbbbb), [coverxit](https://github.com/coverxit), [stanzhai](https://github.com/stanzhai) + +# 語句 +----------------- + +本頁包含內容： + +- [循環語句](#loop_statements) +- [分支語句](#branch_statements) +- [帶標籤的語句](#labeled_statement) +- [控制傳遞語句](#control_transfer_statements) + +在 Swift 中，有兩種類型的語句：簡單語句和控制流語句。簡單語句是最常見的，用於構造表達式和聲明。控制流語句則用於控制程序執行的流程，Swift 中有三種類型的控制流語句：循環語句、分支語句和控制傳遞語句。 + +循環語句用於重複執行代碼塊；分支語句用於執行滿足特定條件的代碼塊；控制傳遞語句則用於修改代碼的執行順序。在稍後的敘述中，將會詳細地介紹每一種類型的控制流語句。 + +是否將分號（`;`）添加到語句的結尾處是可選的。但若要在同一行內寫多條獨立語句，請務必使用分號。 + +> 語句語法 +> *語句* → [*表達式*](..\chapter3\04_Expressions.html#expression) **;** _可選_ +> *語句* → [*聲明*](..\chapter3\05_Declarations.html#declaration) **;** _可選_ +> *語句* → [*循環語句*](..\chapter3\10_Statements.html#loop_statement) **;** _可選_ +> *語句* → [*分支語句*](..\chapter3\10_Statements.html#branch_statement) **;** _可選_ +> *語句* → [*標記語句(Labeled Statement)*](..\chapter3\10_Statements.html#labeled_statement) +> *語句* → [*控制轉移語句*](..\chapter3\10_Statements.html#control_transfer_statement) **;** _可選_ +> *多條語句(Statements)* → [*語句*](..\chapter3\10_Statements.html#statement) [*多條語句(Statements)*](..\chapter3\10_Statements.html#statements) _可選_ + + +## 循環語句 + +取決於特定的循環條件，循環語句允許重複執行代碼塊。Swift 提供四種類型的循環語句：`for`語句、`for-in`語句、`while`語句和`do-while`語句。 + +通過`break`語句和`continue`語句可以改變循環語句的控制流。有關這兩條語句，詳情參見 [Break 語句](#break_statement)和 [Continue 語句](#continue_statement)。 + +> 循環語句語法 +> *循環語句* → [*for語句*](..\chapter3\10_Statements.html#for_statement) +> *循環語句* → [*for-in語句*](..\chapter3\10_Statements.html#for_in_statement) +> *循環語句* → [*while語句*](..\chapter3\10_Statements.html#wheetatype類型ile_statement) +> *循環語句* → [*do-while語句*](..\chapter3\10_Statements.html#do_while_statement) + +### For 語句 + +`for`語句允許在重複執行代碼塊的同時，遞增一個計數器。 + +`for`語句的形式如下： + +> for `initialzation`; `condition`; `increment` { +> `statements` +> } + +*initialzation*、*condition* 和 *increment* 之間的分號，以及包圍循環體 *statements* 的大括號都是不可省略的。 + +`for`語句的執行流程如下： + +1. *initialzation* 只會被執行一次，通常用於聲明和初始化在接下來的循環中需要使用的變量。 +2. 計算 *condition* 表達式： + 如果為`true`，*statements* 將會被執行，然後轉到第3步。如果為`false`，*statements* 和 *increment* 都不會被執行，`for`至此執行完畢。 +3. 計算 *increment* 表達式，然後轉到第2步。 + +定義在 *initialzation* 中的變量僅在`for`語句的作用域以內有效。*condition* 表達式的值的類型必須遵循`LogicValue`協議。 + +> For 循環語法 +> *for語句* → **for** [*for初始條件*](..\chapter3\10_Statements.html#for_init) _可選_ **;** [*表達式*](..\chapter3\04_Expressions.html#expression) _可選_ **;** [*表達式*](..\chapter3\04_Expressions.html#expression) _可選_ [*代碼塊*](..\chapter3\05_Declarations.html#code_block) +> *for語句* → **for** **(** [*for初始條件*](..\chapter3\10_Statements.html#for_init) _可選_ **;** [*表達式*](..\chapter3\04_Expressions.html#expression) _可選_ **;** [*表達式*](..\chapter3\04_Expressions.html#expression) _可選_ **)** [*代碼塊*](..\chapter3\05_Declarations.html#code_block) +> *for初始條件* → [*變量聲明*](..\chapter3\05_Declarations.html#variable_declaration) | [*表達式列表*](..\chapter3\04_Expressions.html#expression_list) + +### For-In 語句 + +`for-in`語句允許在重複執行代碼塊的同時，迭代集合（或遵循`Sequence`協議的任意類型）中的每一項。 + +`for-in`語句的形式如下： + +> for `item` in `collection` { +> `statements` +> } + +`for-in`語句在循環開始前會調用 *collection* 表達式的`generate`方法來獲取一個生成器類型（這是一個遵循`Generator`協議的類型）的值。接下來循環開始，調用 *collection* 表達式的`next`方法。如果其返回值不是`None`，它將會被賦給 *item*，然後執行 *statements*，執行完畢後回到循環開始處；否則，將不會賦值給 *item* 也不會執行 *statements*，`for-in`至此執行完畢。 + +> For-In 循環語法 +> *for-in語句* → **for** [*模式*](..\chapter3\07_Patterns.html#pattern) **in** [*表達式*](..\chapter3\04_Expressions.html#expression) [*代碼塊*](..\chapter3\05_Declarations.html#code_block) + +### While 語句 + +`while`語句允許重複執行代碼塊。 + +`while`語句的形式如下： + +> while `condition` { +> `statements` +> } + +`while`語句的執行流程如下： + +1. 計算 *condition* 表達式： + 如果為真`true`，轉到第2步。如果為`false`，`while`至此執行完畢。 +2. 執行 *statements* ，然後轉到第1步。 + +由於 *condition* 的值在 *statements* 執行前就已計算出，因此`while`語句中的 *statements* 可能會被執行若干次，也可能不會被執行。 + +*condition* 表達式的值的類型必須遵循`LogicValue`協議。同時，*condition* 表達式也可以使用可選綁定，詳情參見[可選綁定](../chapter2/01_The_Basics.html#optional_binding)。 + +> While 循環語法 +> *while語句* → **while** [*while條件*](..\chapter3\10_Statements.html#while_condition) [*代碼塊*](..\chapter3\05_Declarations.html#code_block) +> *while條件* → [*表達式*](..\chapter3\04_Expressions.html#expression) | [*聲明*](..\chapter3\05_Declarations.html#declaration) + +### Do-While 語句 + +`do-while`語句允許代碼塊被執行一次或多次。 + +`do-while`語句的形式如下： + +> do { +> `statements` +> } while `condition` + +`do-while`語句的執行流程如下： + +1. 執行 *statements*，然後轉到第2步。 +2. 計算 *condition* 表達式： + 如果為`true`，轉到第1步。如果為`false`，`do-while`至此執行完畢。 + +由於 *condition* 表達式的值是在 *statements* 執行後才計算出，因此`do-while`語句中的 *statements* 至少會被執行一次。 + +*condition* 表達式的值的類型必須遵循`LogicValue`協議。同時，*condition* 表達式也可以使用可選綁定，詳情參見[可選綁定](../chapter2/01_The_Basics.html#optional_binding)。 + +> Do-While 循環語法 +> *do-while語句* → **do** [*代碼塊*](..\chapter3\05_Declarations.html#code_block) **while** [*while條件*](..\chapter3\10_Statements.html#while_condition) + + +## 分支語句 + +取決於一個或者多個條件的值，分支語句允許程序執行指定部分的代碼。顯然，分支語句中條件的值將會決定如何分支以及執行哪一塊代碼。Swift 提供兩種類型的分支語句：`if`語句和`switch`語句。 + +`switch`語句中的控制流可以用`break`語句修改，詳情請見[Break 語句](#break_statement)。 + +> 分支語句語法 +> *分支語句* → [*if語句*](..\chapter3\10_Statements.html#if_statement) +> *分支語句* → [*switch語句*](..\chapter3\10_Statements.html#switch_statement) + +### If 語句 + +取決於一個或多個條件的值，`if`語句將決定執行哪一塊代碼。 + +`if`語句有兩種標準形式，在這兩種形式裡都必須有大括號。 + +第一種形式是當且僅當條件為真時執行代碼，像下面這樣： + +> if `condition` { +> `statements` +> } + +第二種形式是在第一種形式的基礎上添加 *else 語句*，當只有一個 else 語句時，像下面這樣： + +> if `condition` { +> `statements to execute if condition is true` +> } else { +> `statements to execute if condition is false` +> } + +同時，else 語句也可包含`if`語句，從而形成一條鏈來測試更多的條件，像下面這樣： + +> if `condition 1` { +> `statements to execute if condition 1 is true` +> } else if `condition 2` { +> `statements to execute if condition 2 is true` +> } +> else { +> `statements to execute if both conditions are false` +> } + +`if`語句中條件的值的類型必須遵循`LogicValue`協議。同時，條件也可以使用可選綁定，詳情參見[可選綁定](../chapter2/01_The_Basics.html#optional_binding)。 + +> If語句語法 +> *if語句* → **if** [*if條件*](..\chapter3\10_Statements.html#if_condition) [*代碼塊*](..\chapter3\05_Declarations.html#code_block) [*else子句(Clause)*](..\chapter3\10_Statements.html#else_clause) _可選_ +> *if條件* → [*表達式*](..\chapter3\04_Expressions.html#expression) | [*聲明*](..\chapter3\05_Declarations.html#declaration) +> *else子句(Clause)* → **else** [*代碼塊*](..\chapter3\05_Declarations.html#code_block) | **else** [*if語句*](..\chapter3\10_Statements.html#if_statement) + +### Switch 語句 + +取決於`switch`語句的*控制表達式（control expression）*，`switch`語句將決定執行哪一塊代碼。 + +`switch`語句的形式如下： + +> switch `control expression` { +> case `pattern 1`: +> `statements` +> case `pattern 2` where `condition`: +> `statements` +> case `pattern 3` where `condition`, +> `pattern 4` where `condition`: +> `statements` +> default: +> `statements` +> } + +`switch`語句的*控制表達式（control expression）*會首先被計算，然後與每一個 case 的模式（pattern）進行匹配。如果匹配成功，程序將會執行對應的 case 分支裡的 *statements*。另外，每一個 case 分支都不能為空，也就是說在每一個 case 分支中至少有一條語句。如果你不想在匹配到的 case 分支中執行代碼，只需在該分支裡寫一條`break`語句即可。 + +可以用作控制表達式的值是十分靈活的，除了標量類型(scalar types，如`Int`、`Character`)外，你可以使用任何類型的值，包括浮點數、字符串、元組、自定義類的實例和可選（optional）類型，甚至是枚舉類型中的成員值和指定的範圍(range)等。關於在`switch`語句中使用這些類型，詳情參見[控制流](../chapter2/05_Control_Flow.html)一章的 [Switch](../chapter2/05_Control_Flow.html#switch)。 + +你可以在模式後面添加一個起保護作用的表達式(guard expression)。*起保護作用的表達式*是這樣構成的：關鍵字`where`後面跟著一個作為額外測試條件的表達式。因此，當且僅當*控制表達式*匹配一個*case*的某個模式且起保護作用的表達式為真時，對應 case 分支中的 *statements* 才會被執行。在下面的例子中，*控制表達式*只會匹配含兩個相等元素的元組，如`(1, 1)`： + +```swift +case let (x, y) where x == y: +``` + +正如上面這個例子，也可以在模式中使用`let`（或`var`）語句來綁定常量（或變量）。這些常量（或變量）可以在其對應的起保護作用的表達式和其對應的*case*塊裡的代碼中引用。但是，如果 case 中有多個模式匹配控制表達式，那麼這些模式都不能綁定常量（或變量）。 + +`switch`語句也可以包含默認（`default`）分支，只有其它 case 分支都無法匹配控制表達式時，默認分支中的代碼才會被執行。一個`switch`語句只能有一個默認分支，而且必須在`switch`語句的最後面。 + +儘管模式匹配操作實際的執行順序，特別是模式的計算順序是不可知的，但是 Swift 規定`switch`語句中的模式匹配的順序和書寫源代碼的順序保持一致。因此，當多個模式含有相同的值且能夠匹配控制表達式時，程序只會執行源代碼中第一個匹配的 case 分支中的代碼。 + +#### Switch 語句必須是完備的 + +在 Swift 中，`switch`語句中控制表達式的每一個可能的值都必須至少有一個 case 分支與之對應。在某些情況下（例如，表達式的類型是`Int`），你可以使用默認塊滿足該要求。 + +#### 不存在隱式的貫穿(fall through) + +當匹配的 case 分支中的代碼執行完畢後，程序會終止`switch`語句，而不會繼續執行下一個 case 分支。這就意味著，如果你想執行下一個 case 分支，需要顯式地在你需要的 case 分支裡使用`fallthrough`語句。關於`fallthrough`語句的更多信息，詳情參見 [Fallthrough 語句](#fallthrough_statement)。 + +> Switch語句語法 +> *switch語句* → **switch** [*表達式*](..\chapter3\04_Expressions.html#expression) **{** [*SwitchCase列表*](..\chapter3\10_Statements.html#switch_cases) _可選_ **}** +> *SwitchCase列表* → [*SwitchCase*](..\chapter3\10_Statements.html#switch_case) [*SwitchCase列表*](..\chapter3\10_Statements.html#switch_cases) _可選_ +> *SwitchCase* → [*case標籤*](..\chapter3\10_Statements.html#case_label) [*多條語句(Statements)*](..\chapter3\10_Statements.html#statements) | [*default標籤*](..\chapter3\10_Statements.html#default_label) [*多條語句(Statements)*](..\chapter3\10_Statements.html#statements) +> *SwitchCase* → [*case標籤*](..\chapter3\10_Statements.html#case_label) **;** | [*default標籤*](..\chapter3\10_Statements.html#default_label) **;** +> *case標籤* → **case** [*case項列表*](..\chapter3\10_Statements.html#case_item_list) **:** +> *case項列表* → [*模式*](..\chapter3\07_Patterns.html#pattern) [*guard-clause*](..\chapter3\10_Statements.html#guard_clause) _可選_ | [*模式*](..\chapter3\07_Patterns.html#pattern) [*guard-clause*](..\chapter3\10_Statements.html#guard_clause) _可選_ **,** [*case項列表*](..\chapter3\10_Statements.html#case_item_list) +> *default標籤* → **default** **:** +> *guard-clause* → **where** [*guard-expression*](..\chapter3\10_Statements.html#guard_expression) +> *guard-expression* → [*表達式*](..\chapter3\04_Expressions.html#expression) + + + 帶標籤的語句 + +你可以在循環語句或`switch`語句前面加上*標籤*，它由標籤名和緊隨其後的冒號(:)組成。在`break`和`continue`後面跟上標籤名可以顯式地在循環語句或`switch`語句中更改控制流，把控制權傳遞給指定標籤標記的語句。關於這兩條語句用法，詳情參見 [Break 語句](#break_statement)和 [Continue 語句](#continue_statement)。 + +標籤的作用域是該標籤所標記的語句之後的所有語句。你可以不使用帶標籤的語句，但只要使用它，標籤名就必唯一。 + +關於使用帶標籤的語句的例子，詳情參見[控制流](../chapter2/05_Control_Flow.html)一章的[帶標籤的語句](../chapter2/05_Control_Flow.html#labeled_statements)。 + +> 標記語句語法 +> *標記語句(Labeled Statement)* → [*語句標籤*](..\chapter3\10_Statements.html#statement_label) [*循環語句*](..\chapter3\10_Statements.html#loop_statement) | [*語句標籤*](..\chapter3\10_Statements.html#statement_label) [*switch語句*](..\chapter3\10_Statements.html#switch_statement) +> *語句標籤* → [*標籤名稱*](..\chapter3\10_Statements.html#label_name) **:** +> *標籤名稱* → [*標識符*](..\chapter3\02_Lexical_Structure.html#identifier) + +## 控制傳遞語句 + +通過無條件地把控制權從一片代碼傳遞到另一片代碼，控制傳遞語句能夠改變代碼執行的順序。Swift 提供四種類型的控制傳遞語句：`break`語句、`continue`語句、`fallthrough`語句和`return`語句。 + +> 控制傳遞語句(Control Transfer Statement) 語法 +> *控制傳遞語句* → [*break語句*](..\chapter3\10_Statements.html#break_statement) +> *控制傳遞語句* → [*continue語句*](..\chapter3\10_Statements.html#continue_statement) +> *控制傳遞語句* → [*fallthrough語句*](..\chapter3\10_Statements.html#fallthrough_statement) +> *控制傳遞語句* → [*return語句*](..\chapter3\10_Statements.html#return_statement) + + +### Break 語句 + +`break`語句用於終止循環或`switch`語句的執行。使用`break`語句時，可以只寫`break`這個關鍵詞，也可以在`break`後面跟上標籤名（label name），像下面這樣： + +> break +> break `label name` + +當`break`語句後面帶標籤名時，可用於終止由這個標籤標記的循環或`switch`語句的執行。 + +而當只寫`break`時，則會終止`switch`語句或上下文中包含`break`語句的最內層循環的執行。 + +在這兩種情況下，控制權都會被傳遞給循環或`switch`語句外面的第一行語句。 + +關於使用`break`語句的例子，詳情參見[控制流](../chapter2/05_Control_Flow.html)一章的 [Break](../chapter2/05_Control_Flow.html#break) 和[帶標籤的語句](../chapter2/05_Control_Flow.html#labeled_statements)。 + +> Break 語句語法 +> *break語句* → **break** [*標籤名稱*](..\chapter3\10_Statements.html#label_name) _可選_ + + +### Continue 語句 + +`continue`語句用於終止循環中當前迭代的執行，但不會終止該循環的執行。使用`continue`語句時，可以只寫`continue`這個關鍵詞，也可以在`continue`後面跟上標籤名（label name），像下面這樣： + +> continue +> continue `label name` + +當`continue`語句後面帶標籤名時，可用於終止由這個標籤標記的循環中當前迭代的執行。 + +而當只寫`break`時，可用於終止上下文中包含`continue`語句的最內層循環中當前迭代的執行。 + +在這兩種情況下，控制權都會被傳遞給循環外面的第一行語句。 + +在`for`語句中，`continue`語句執行後，*increment* 表達式還是會被計算，這是因為每次循環體執行完畢後 *increment* 表達式都會被計算。 + +關於使用`continue`語句的例子，詳情參見[控制流](../chapter2/05_Control_Flow.html)一章的 [Continue](../chapter2/05_Control_Flow.html#continue) 和[帶標籤的語句](../chapter2/05_Control_Flow.html#labeled_statements)。 + +> Continue 語句語法 +> *continue語句* → **continue** [*標籤名稱*](..\chapter3\10_Statements.html#label_name) _可選_ + + +### Fallthrough 語句 + +`fallthrough`語句用於在`switch`語句中傳遞控制權。`fallthrough`語句會把控制權從`switch`語句中的一個 case 傳遞給下一個 case 。這種傳遞是無條件的，即使下一個 case 的模式與`switch`語句的控制表達式的值不匹配。 + +`fallthrough`語句可出現在`switch`語句中的任意 case 裡，但不能出現在最後一個 case 分支中。同時，`fallthrough`語句也不能把控制權傳遞給使用了可選綁定的 case 分支。 + +關於在`switch`語句中使用`fallthrough`語句的例子，詳情參見[控制流](../chapter2/05_Control_Flow.html)一章的[控制傳遞語句](../chapter2/05_Control_Flow.html#control_transfer_statements)。 + +> Fallthrough 語句語法 +> *fallthrough語句* → **fallthrough** + +### Return 語句 + +`return`語句用於在函數或方法的實現中將控制權傳遞給調用者，接著程序將會從調用者的位置繼續向下執行。 + +使用`return`語句時，可以只寫`return`這個關鍵詞，也可以在`return`後面跟上表達式，像下面這樣： + +> return +> return `expression` + +當`return`語句後面帶表達式時，表達式的值將會返回給調用者。如果表達式值的類型與調用者期望的類型不匹配，Swift 則會在返回表達式的值之前將表達式值的類型轉換為調用者期望的類型。 + +而當只寫`return`時，僅僅是將控制權從該函數或方法傳遞給調用者，而不返回一個值。（這就是說，該函數或方法的返回類型為`Void`或`()`） + +> Return 語句語法 +> *return語句* → **return** [*表達式*](..\chapter3\04_Expressions.html#expression) _可選_ diff --git a/source-tw/chapter3/chapter3.md b/source-tw/chapter3/chapter3.md new file mode 100644 index 00000000..e69de29b diff --git a/source-tw/cover.jpg b/source-tw/cover.jpg new file mode 100644 index 0000000000000000000000000000000000000000..ec72c5a4f8f6f6fa18485bbe6f848d53143cbf2d GIT binary patch literal 173792 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 A)&Kwi literal 0 HcmV?d00001 diff --git a/source-tw/cover_small.jpg b/source-tw/cover_small.jpg new file mode 100644 index 0000000000000000000000000000000000000000..04bafd228e1e49fd0dff130fe55fda2d0411689f GIT binary patch literal 9108 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 P-AXY?IwnaO#F+a(7;