Merge pull request #1 from numbbbbb/gh-pages

merge

Author: mmoaay

CNAME

@@ -1 +1 @@
-www.swiftguide.cn
+gg.swiftguide.cn

README.md

@@ -1,21 +1,25 @@
 《The Swift Programming Language》in Chinese
 =============================================
 
-中文版Apple官方Swift教程《The Swift Programming Language》
+中文版 Apple 官方 Swift 教程《The Swift Programming Language》
 
 [英文原版](https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/index.html#//apple_ref/doc/uid/TP40014097-CH3-ID0)
 
 **如果想帮忙翻译或者校对，请加QQ群：480616051，谢谢！**
 
 # 在线阅读
 
-使用Gitbook制作，可以直接[在线阅读](http://swiftguide.cn/)。
+使用 Gitbook 制作，可以直接[在线阅读](http://swiftguide.cn/)。
 
 # 当前阶段
 
-已经更新到Swift 2.0，对应苹果官方文档7.23的更新。
+已经更新到 Swift 2.2。
 
-# 2.0译者记录
+# 2.1 & 2.2 译者记录
+
+详见各章节开头位置。
+
+# 2.0 译者记录
 
 - About Swift （[xtymichael](https://github.com/xtymichael)）
 - A Swift Tour（[xtymichael](https://github.com/xtymichael)）
@@ -55,7 +59,7 @@
 - Generic Parameters and Arguments（[wardenNScaiyi](https://github.com/wardenNScaiyi)）
 - Summary of the Grammar（[miaosiqi](https://github.com/miaosiqi)）
 
-# 1.0译者记录
+# 1.0 译者记录
 
 * 欢迎使用 Swift
    * 关于 Swift ([numbbbbb])

cover/cover.jpg

@@ -76,7 +76,7 @@ println(sayHelloAgain("Anna"))
 func halfOpenRangeLength(start: Int, end: Int) -> Int {
     return end - start
 }
-println(halfOpenRangeLength(1, 10))
+println(halfOpenRangeLength(1, end:10))
 // prints "9"
 ```
 

cover/cover_2.0.jpg

@@ -1,16 +1,15 @@
+> 已同步更新到 Swift 2.2
+
 # 2.0 新的开始
 
 > Swift 兴趣交流群：`131595168`, `146932759`, `151336833`, `153549217`. **加入一个群即可，请勿重复添加**
 
-> <a target='_blank' href="http://swiftist.org">Swift 开发者社区</a>
-
-> <a target='_blank' href="https://github.com/ipader/SwiftGuide">Swift 资源汇总</a>
-
-> <a target='_blank' href="http://swiftsandbox.io">Swift 优秀newsletter</a>
+> <a target='_blank' href="http://swiftweekly.cn">订阅 Swift 开发者周报，每周获取最新 Swift 资源</a>
 
 <!-- -->
 > 如果您觉得这个项目不错，请<a target='_blank' href="https://github.com/numbbbbb/the-swift-programming-language-in-chinese">点击Star一下</a>，您的支持是我们最大的动力。
 
+
 ## 1
 
 开源项目完成难，维护更难。
@@ -72,5 +71,6 @@ Swift 2.0 参与者名单（按照章节顺序）：
 - [ray16897188](https://github.com/ray16897188)
 - [wardenNScaiyi](https://github.com/wardenNScaiyi)
 - [miaosiqi](https://github.com/miaosiqi)
+- [Realank](https://github.com/Realank)
 
-最后，感谢[极客学院](http://wiki.jikexueyuan.com)提供的wiki系统，在国内访问起来速度很快，优化后的样式看起来也更舒服。
+最后，感谢[极客学院](http://wiki.jikexueyuan.com)提供的wiki系统，在国内访问起来速度很快，优化后的样式看起来也更舒服。

source-tw/chapter2/06_Functions.md

@@ -17,7 +17,7 @@
    * [类和结构体](chapter2/09_Classes_and_Structures.md)
    * [属性](chapter2/10_Properties.md)
    * [方法](chapter2/11_Methods.md)
-   * [下标脚本](chapter2/12_Subscripts.md)
+   * [下标](chapter2/12_Subscripts.md)
    * [继承](chapter2/13_Inheritance.md)
    * [构造过程](chapter2/14_Initialization.md)
    * [析构过程](chapter2/15_Deinitialization.md)
@@ -29,8 +29,8 @@
    * [扩展](chapter2/21_Extensions.md)
    * [协议](chapter2/22_Protocols.md)
    * [泛型](chapter2/23_Generics.md)
-   * [权限控制](chapter2/24_Access_Control.md)
-   * [高级操作符](chapter2/25_Advanced_Operators.md)
+   * [访问控制](chapter2/24_Access_Control.md)
+   * [高级运算符](chapter2/25_Advanced_Operators.md)
 * 语言参考
    * [关于语言参考](chapter3/01_About_the_Language_Reference.md)
    * [词法结构](chapter3/02_Lexical_Structure.md)

source/README.md

@@ -9,6 +9,9 @@
 > 2.0
 > 翻译+校对：[xtymichael](https://github.com/xtymichael)
 
+> 2.2
+> 翻译：[175](https://github.com/Brian175)，2016-04-09 校对：[SketchK](https://github.com/SketchK)，2016-05-11
+
 本页内容包括：
 
 -   [简单值（Simple Values）](#simple_values)
@@ -17,6 +20,7 @@
 -   [对象和类（Objects and Classes）](#objects_and_classes)
 -   [枚举和结构体（Enumerations and Structures）](#enumerations_and_structures)
 -   [协议和扩展（Protocols and Extensions）](#protocols_and_extensions)
+-   [错误处理（Error Handling）](#error_handling)
 -   [泛型（Generics）](#generics)
 
 通常来说，编程语言教程中的第一个程序应该在屏幕上打印“Hello, world”。在 Swift 中，可以用一行代码实现：
@@ -30,8 +34,7 @@ print("Hello, world!")
 这个教程会通过一系列编程例子来让你对 Swift 有初步了解，如果你有什么不理解的地方也不用担心——任何本章介绍的内容都会在后面的章节中详细讲解。
 
 > 注意：
-> 为了获得最好的体验，在 Xcode 当中使用代码预览功能。代码预览功能可以让你编辑代码并实时看到运行结果。
-> <a href="https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/GuidedTour.playground.zip">下载Playground</a>
+> 在 Mac 上，下载 Playground 并双击文件在 Xcode 里打开：[https://developer.apple.com/go/?id=swift-tour](https://developer.apple.com/go/?id=swift-tour)
 
 <a name="simple_values"></a>
 ## 简单值
@@ -142,7 +145,13 @@ if let name = optionalName {
 > 练习：
 > 把`optionalName`改成`nil`，greeting会是什么？添加一个`else`语句，当`optionalName`是`nil`时给greeting赋一个不同的值。
 
-如果变量的可选值是`nil`，条件会判断为`false`，大括号中的代码会被跳过。如果不是`nil`，会将值赋给`let`后面的常量，这样代码块中就可以使用这个值了。
+如果变量的可选值是`nil`，条件会判断为`false`，大括号中的代码会被跳过。如果不是`nil`，会将值赋给`let`后面的常量，这样代码块中就可以使用这个值了。  
+另一种处理可选值的方法是通过使用 ?? 操作符来提供一个默认值。如果可选值缺失的话，可以使用默认值来代替。   
+```swift
+let nickName: String? = nil
+let fullName: String = "John Appleseed"
+let informalGreeting = "Hi \(nickName ?? fullName)"
+```
 
 `switch`支持任意类型的数据以及各种比较操作——不仅仅是整数以及测试相等。
 
@@ -188,7 +197,7 @@ print(largest)
 ```
 
 > 练习：
-> 添加另一个变量来记录现在和之前最大数字的类型。
+> 添加另一个变量来记录最大数字的种类(kind)，同时仍然记录这个最大数字的值。
 
 使用`while`来重复运行一段代码直到不满足条件。循环条件也可以在结尾，保证能至少循环一次。
 
@@ -206,20 +215,14 @@ repeat {
 print(m)
 ```
 
-你可以在循环中使用`..<`来表示范围，也可以使用传统的写法，两者是等价的：
+你可以在循环中使用`..<`来表示范围。
 
 ```swift
-var firstForLoop = 0
+var total = 0
 for i in 0..<4 {
-    firstForLoop += i
-}
-print(firstForLoop)
-
-var secondForLoop = 0
-for var i = 0; i < 4; ++i {
-    secondForLoop += i
+	total += i
 }
-print(secondForLoop)
+print(total)
 ```
 
 使用`..<`创建的范围不包含上界，如果想包含的话需要使用`...`。
@@ -534,7 +537,7 @@ let aceRawValue = ace.rawValue
 > 练习：
 > 写一个函数，通过比较它们的原始值来比较两个`Rank`值。
 
-在上面的例子中，枚举原始值的类型是`Int`，所以你只需要设置第一个原始值。剩下的原始值会按照顺序赋值。你也可以使用字符串或者浮点数作为枚举的原始值。使用`rawValue`属性来访问一个枚举成员的原始值。
+默认情况下，Swift 按照从 0 开始每次加 1 的方式为原始值进行赋值，不过你可以通过显式赋值进行改变。在上面的例子中，`Ace`被显式赋值为 1，并且剩下的原始值会按照顺序赋值。你也可以使用字符串或者浮点数作为枚举的原始值。使用`rawValue`属性来访问一个枚举成员的原始值。
 
 使用`init?(rawValue:)`初始化构造器在原始值和枚举值之间进行转换。
 
@@ -544,7 +547,7 @@ if let convertedRank = Rank(rawValue: 3) {
 }
 ```
 
-枚举的成员值是实际值，并不是原始值的另一种表达方法。实际上，以防原始值没有意义，你不需要设置。
+枚举的成员值是实际值，并不是原始值的另一种表达方法。实际上，如果没有比较有意义的原始值，你就不需要提供原始值。
 
 ```swift
 enum Suit {
@@ -595,24 +598,24 @@ let threeOfSpadesDescription = threeOfSpades.simpleDescription()
 ```swift
 enum ServerResponse {
     case Result(String, String)
-    case Error(String)
+    case Failure(String)
 }
 
 let success = ServerResponse.Result("6:00 am", "8:09 pm")
-let failure = ServerResponse.Error("Out of cheese.")
+let failure = ServerResponse.Failure("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)"
+case let .Failure(message):
+    print("Failure...  \(message)")
 }
 ```
 
 > 练习：
 > 给`ServerResponse`和`switch`添加第三种情况。
 
-注意如何从`ServerResponse`中提取日升和日落时间并用得到的值用来和`switch`的情况作比较。
+注意日升和日落时间是如何从`ServerResponse`中提取到并与`switch`的`case`相匹配的。
 
 <a name="protocols_and_extensions"></a>
 ## 协议和扩展
@@ -683,6 +686,88 @@ print(protocolValue.simpleDescription)
 
 即使`protocolValue`变量运行时的类型是`simpleClass`，编译器会把它的类型当做`ExampleProtocol`。这表示你不能调用类在它实现的协议之外实现的方法或者属性。
 
+<a name="error_handling"></a>
+## 错误处理
+
+使用采用`ErrorType`协议的类型来表示错误。
+
+```swift
+enum PrinterError: ErrorType {
+	case OutOfPaper
+	case NoToner
+	case OnFire
+}
+```
+
+使用`throw`来抛出一个错误并使用`throws`来表示一个可以抛出错误的函数。如果在函数中抛出一个错误，这个函数会立刻返回并且调用该函数的代码会进行错误处理。
+
+```swift
+func sendToPrinter(printerName: String) throws -> String {
+	if printerName == "Never Has Toner" {
+		throw PrinterError.NoToner
+	}
+	return "Job sent"
+}
+```
+
+有多种方式可以用来进行错误处理。一种方式是使用`do-catch`。在`do`代码块中，使用`try`来标记可以抛出错误的代码。在`catch`代码块中，除非你另外命名，否则错误会自动命名为`error`。
+
+```swift
+do {
+	let printerResponse = try sendToPrinter("Bi Sheng")
+	print(printerResponse)
+} catch {
+	print(error)
+}
+```
+
+> 练习：
+> 将 printer name 改为`"Never Has Toner"`使`sendToPrinter(_:)`函数抛出错误。
+
+可以使用多个`catch`块来处理特定的错误。参照 switch 中的`case`风格来写`catch`。
+
+```swift
+do {
+	let printerResponse = try sendToPrinter("Gutenberg")
+	print(printerResponse)
+} catch PrinterError.OnFire {
+	print("I'll just put this over here, with the rest of the fire.")
+} catch let printerError as PrinterError {
+	print("Printer error: \(printerError).")
+} catch {
+	print(error)
+}
+```
+
+> 练习：
+> 在`do`代码块中添加抛出错误的代码。你需要抛出哪种错误来使第一个`catch`块进行接收？怎么使第二个和第三个`catch`进行接收呢？
+
+另一种处理错误的方式使用`try?`将结果转换为可选的。如果函数抛出错误，该错误会被抛弃并且结果为`nil`。否则的话，结果会是一个包含函数返回值的可选值。
+
+```swift
+let printerSuccess = try? sendToPrinter("Mergenthaler")
+let printerFailure = try? sendToPrinter("Never Has Toner")
+```
+
+使用`defer`代码块来表示在函数返回前，函数中最后执行的代码。无论函数是否会抛出错误，这段代码都将执行。使用`defer`，可以把函数调用之初就要执行的代码和函数调用结束时的扫尾代码写在一起，虽然这两者的执行时机截然不同。
+
+```swift
+var fridgeIsOpen = false
+let fridgeContent = ["milk", "eggs", "leftovers"]
+
+func fridgeContains(itemName: String) -> Bool {
+	fridgeIsOpen = true
+	defer {
+		fridgeIsOpen = false
+	}
+	
+	let result = fridgeContent.contains(itemName)
+	return result
+}
+fridgeContains("banana")
+print(fridgeIsOpen)
+```
+
 <a name="generics"></a>
 ## 泛型