andre/the-swift-programming-language-in-chinese
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

check: about swift && a swift tour

Browse Source
This commit is contained in:
zhangsiqi04
2017-04-21 18:00:42 +08:00
parent d18f3d02e1
commit ee858e3bb0
2 changed files with 107 additions and 110 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
source/chapter1/01_swift.md
View File

@ -10,6 +10,8 @@
> >
> 3.0 翻译+校对：[shanks](http://codebuild.me)，2016-10-06 > 3.0 翻译+校对：[shanks](http://codebuild.me)，2016-10-06
> 3.0.1 review : 2016-11-09 > 3.0.1 review : 2016-11-09
>
> 3.1 校对: [SketchK](https://github.com/SketchK) 2017-04-08
Swift 是一种新的编程语言，用于编写 iOS，macOS，watchOS 和 tvOS 的应用程序。Swift 结合了 C 和 Objective-C 的优点并且不受 C 兼容性的限制。Swift 采用安全的编程模式并添加了很多新特性，这将使编程更简单，更灵活，也更有趣。Swift 是基于成熟而且倍受喜爱的 Cocoa 和 Cocoa Touch 框架，它的降临将重新定义软件开发。 Swift 是一种新的编程语言，用于编写 iOS，macOS，watchOS 和 tvOS 的应用程序。Swift 结合了 C 和 Objective-C 的优点并且不受 C 兼容性的限制。Swift 采用安全的编程模式并添加了很多新特性，这将使编程更简单，更灵活，也更有趣。Swift 是基于成熟而且倍受喜爱的 Cocoa 和 Cocoa Touch 框架，它的降临将重新定义软件开发。

93
source/chapter1/02_a_swift_tour.md
View File

@ -16,6 +16,9 @@
> 翻译+校对：[shanks](http://codebuild.me)，2016-10-06 > 翻译+校对：[shanks](http://codebuild.me)，2016-10-06
> 3.0.1 review: 2016-11-09 > 3.0.1 review: 2016-11-09
>
> 3.1 校对: [SketchK](https://github.com/SketchK) 2017-04-08
本页内容包括： 本页内容包括：
@ -39,14 +42,12 @@ print("Hello, world!")
这个教程会通过一系列编程例子来让你对 Swift 有初步了解，如果你有什么不理解的地方也不用担心——任何本章介绍的内容都会在后面的章节中详细讲解到。 这个教程会通过一系列编程例子来让你对 Swift 有初步了解，如果你有什么不理解的地方也不用担心——任何本章介绍的内容都会在后面的章节中详细讲解到。
> 注意： > 注意：
> 最佳实践是，在 Xcode 作为 playground 打开本章，Playgrounds允许你编辑你的代码并且立即得到结果。 > 在 Mac 中下载 Playground 文件并用双击的方式在 Xcode 中打开：[https://developer.apple.com/go/?id=swift-tour](https://developer.apple.com/go/?id=swift-tour)
>
> [下载 Playground](https://developer.apple.com/library/content/documentation/Swift/Conceptual/Swift_Programming_Language/GuidedTour.playground.zip)
<a name="simple_values"></a> <a name="simple_values"></a>
## 简单值 ## 简单值
使用`let`来声明常量，使用`var`来声明变量。一个常量的值，在编译的时候，并不需要有明确的值，但是你只能为它赋值一次。也就是说你可以用常量来表示这样一个值：你只需要决定一次，但是需要使用很多次。 使用 `let` 来声明常量，使用 `var` 来声明变量。一个常量的值，在编译的时候，并不需要有明确的值，但是你只能为它赋值一次。这说明你可以用一个常量来命名一个值，一次赋值就即可在多个地方使用。
```swift ```swift
var myVariable = 42 var myVariable = 42
@ -54,7 +55,7 @@ myVariable = 50
let myConstant = 42 let myConstant = 42
``` ```
常量或者变量的类型必须和你赋给它们的值一样。然而，你不用明确地声明类型，声明的同时赋值的话，编译器会自动推断类型。在上面的例子中，编译器推断出`myVariable`是一个整数（integer）因为它的初始值是整数。 常量或者变量的类型必须和你赋给它们的值一样。然而，你不用明确地声明类型，声明的同时赋值的话，编译器会自动推断类型。在上面的例子中，编译器推断出 `myVariable` 是一个整数类型（integer）因为它的初始值是整数。
如果初始值没有提供足够的信息（或者没有初始值），那你需要在变量后面声明类型，用冒号分割。 如果初始值没有提供足够的信息（或者没有初始值），那你需要在变量后面声明类型，用冒号分割。
@ -180,7 +181,6 @@ default:
> 练习： > 练习：
> 删除 `default` 语句，看看会有什么错误？ > 删除 `default` 语句，看看会有什么错误？
注意 `let` 在上述例子的等式中是如何使用的，它将匹配等式的值赋给常量 `x`。 注意 `let` 在上述例子的等式中是如何使用的，它将匹配等式的值赋给常量 `x`。
运行 `switch` 中匹配到的子句之后，程序会退出 `switch` 语句，并不会继续向下运行，所以不需要在每个子句结尾写 `break`。 运行 `switch` 中匹配到的子句之后，程序会退出 `switch` 语句，并不会继续向下运行，所以不需要在每个子句结尾写 `break`。
@ -252,7 +252,7 @@ greet(person:"Bob", day: "Tuesday")
默认情况下，函数使用它们的参数名称作为它们参数的标签，在参数名称前可以自定义参数标签，或者使用 `_` 表示不使用参数标签。 默认情况下，函数使用它们的参数名称作为它们参数的标签，在参数名称前可以自定义参数标签，或者使用 `_` 表示不使用参数标签。
``` ```swift
func greet(_ person: String, on day: String) -> String { func greet(_ person: String, on day: String) -> String {
return "Hello \(person), today is \(day)." return "Hello \(person), today is \(day)."
} }
@ -345,7 +345,7 @@ var numbers = [20, 19, 7, 12]
hasAnyMatches(list: numbers, condition: lessThanTen) hasAnyMatches(list: numbers, condition: lessThanTen)
``` ```
函数实际上是一种特殊的闭包:它是一段能之后被调取的代码。闭包中的代码能访问闭包所建作用域中能得到的变量和函数，即使闭包是在一个不同的作用域被执行的 - 你已经在嵌套函数例子中所看到。你可以使用`{}`来创建一个匿名闭包。使用`in`将参数和返回值类型声明与闭包函数体进行分离。 函数实际上是一种特殊的闭包:它是一段能之后被调取的代码。闭包中的代码能访问闭包作用域中的变量和函数，即使闭包是在一个不同的作用域被执行的 - 你已经在嵌套函数的例子中看过了。你可以使用 `{}` 来创建一个匿名闭包。使用 `in` 将参数和返回值类型的声明与闭包函数体进行分离。
```swift ```swift
numbers.map({ numbers.map({
@ -358,7 +358,7 @@ numbers.map({
> 练习： > 练习：
> 重写闭包，对所有奇数返回 0。 > 重写闭包，对所有奇数返回 0。
有很多种创建更简洁的闭包的方法。如果一个闭包的类型已知，比如作为一个回调函数，你可以忽略参数的类型和返回值。单个语句闭包会把它语句的值当做结果返回。 有很多种创建更简洁的闭包的方法。如果一个闭包的类型已知，比如作为一个代理的回调，你可以忽略参数，返回值，甚至两个都忽略。单个语句闭包会把它语句的值当做结果返回。
```swift ```swift
let mappedNumbers = numbers.map({ number in 3 * number }) let mappedNumbers = numbers.map({ number in 3 * number })
@ -368,7 +368,7 @@ print(mappedNumbers)
你可以通过参数位置而不是参数名字来引用参数——这个方法在非常短的闭包中非常有用。当一个闭包作为最后一个参数传给一个函数的时候，它可以直接跟在括号后面。当一个闭包是传给函数的唯一参数，你可以完全忽略括号。 你可以通过参数位置而不是参数名字来引用参数——这个方法在非常短的闭包中非常有用。当一个闭包作为最后一个参数传给一个函数的时候，它可以直接跟在括号后面。当一个闭包是传给函数的唯一参数，你可以完全忽略括号。
```swift ```swift
let sortedNumbers = numbers.sort { $0 > $1 } let sortedNumbers = numbers.sorted { $0 > $1 }
print(sortedNumbers) print(sortedNumbers)
``` ```
@ -414,11 +414,11 @@ class NamedShape {
} }
``` ```
注意`self`被用来区别实例变量。当你创建实例的时候，像传入函数参数一样给类传入构造器的参数。每个属性都需要赋值——无论是通过声明（就像`numberOfSides`）还是通过构造器（就像`name`）。 注意 `self` 被用来区别实例变量 `name` 和构造器的参数 `name`。当你创建实例的时候，像传入函数参数一样给类传入构造器的参数。每个属性都需要赋值——无论是通过声明（就像 `numberOfSides` ）还是通过构造器（就像 `name`）。
如果你需要在删除对象之前进行一些清理工作，使用 `deinit` 创建一个析构函数。 如果你需要在删除对象之前进行一些清理工作，使用 `deinit` 创建一个析构函数。
子类的定义方法是在它们的类名后面加上父类的名字，用冒号分割。创建类的时候并不需要一个标准的根类，所以你可以忽略父类。 子类的定义方法是在它们的类名后面加上父类的名字，用冒号分割。创建类的时候并不需要一个标准的根类，所以你可以根据需要添加或者忽略父类。
子类如果要重写父类的方法的话，需要用 `override` 标记——如果没有添加 `override` 就重写父类方法的话编译器会报错。编译器同样会检测 `override` 标记的方法是否确实在父类中。 子类如果要重写父类的方法的话，需要用 `override` 标记——如果没有添加 `override` 就重写父类方法的话编译器会报错。编译器同样会检测 `override` 标记的方法是否确实在父类中。
@ -470,7 +470,7 @@ class EquilateralTriangle: NamedShape {
} }
override func simpleDescription() -> String { override func simpleDescription() -> String {
return "An equilateral triagle with sides of length \(sideLength)." return "An equilateral triangle with sides of length \(sideLength)."
} }
} }
var triangle = EquilateralTriangle(sideLength: 3.1, name: "a triangle") var triangle = EquilateralTriangle(sideLength: 3.1, name: "a triangle")
@ -487,9 +487,7 @@ print(triangle.sideLength)
2. 调用父类的构造器 2. 调用父类的构造器
3. 改变父类定义的属性值。其他的工作比如调用方法、getters 和 setters 也可以在这个阶段完成。 3. 改变父类定义的属性值。其他的工作比如调用方法、getters 和 setters 也可以在这个阶段完成。
如果你不需要计算属性，但是仍然需要在设置一个新值之前或者之后运行代码，使用`willSet`和`didSet`。 如果你不需要计算属性，但是仍然需要在设置一个新值之前或者之后运行代码，使用 `willSet` 和 `didSet` 。写入的代码会在属性值发生改变时调用，但不包含构造器中发生值改变的情况。比如，下面的类确保三角形的边长总是和正方形的边长相同。
比如，下面的类确保三角形的边长总是和正方形的边长相同。
```swift ```swift
class TriangleAndSquare { class TriangleAndSquare {
@ -529,25 +527,25 @@ let sideLength = optionalSquare?.sideLength
```swift ```swift
enum Rank: Int { enum Rank: Int {
case Ace = 1 case ace = 1
case Two, Three, Four, Five, Six, Seven, Eight, Nine, Ten case two, three, four, five, six, seven, eight, nine, ten
case Jack, Queen, King case jack, queen, king
func simpleDescription() -> String { func simpleDescription() -> String {
switch self { switch self {
case .Ace: case .ace:
return "ace" return "ace"
case .Jack: case .jack:
return "jack" return "jack"
case .Queen: case .queen:
return "queen" return "queen"
case .King: case .king:
return "king" return "king"
default: default:
return String(self.rawValue) return String(self.rawValue)
} }
} }
} }
let ace = Rank.Ace let ace = Rank.ace
let aceRawValue = ace.rawValue let aceRawValue = ace.rawValue
``` ```
@ -556,7 +554,7 @@ let aceRawValue = ace.rawValue
默认情况下，Swift 按照从 0 开始每次加 1 的方式为原始值进行赋值，不过你可以通过显式赋值进行改变。在上面的例子中，`Ace` 被显式赋值为 1，并且剩下的原始值会按照顺序赋值。你也可以使用字符串或者浮点数作为枚举的原始值。使用 `rawValue` 属性来访问一个枚举成员的原始值。 默认情况下，Swift 按照从 0 开始每次加 1 的方式为原始值进行赋值，不过你可以通过显式赋值进行改变。在上面的例子中，`Ace` 被显式赋值为 1，并且剩下的原始值会按照顺序赋值。你也可以使用字符串或者浮点数作为枚举的原始值。使用 `rawValue` 属性来访问一个枚举成员的原始值。
使用`init?(rawValue:)`初始化构造器在原始值和枚举值之间进行转换。 使用 `init?(rawValue:)` 初始化构造器来创建一个带有原始值的枚举成员。如果存在与原始值相应的枚举成员就返回该枚举成员，否则就返回 `nil`。
```swift ```swift
if let convertedRank = Rank(rawValue: 3) { if let convertedRank = Rank(rawValue: 3) {
@ -564,57 +562,54 @@ if let convertedRank = Rank(rawValue: 3) {
} }
``` ```
枚举的成员值是实际值，并不是原始值的另一种表达方法。实际上，如果没有比较有意义的原始值，你就不需要提供原始值。 枚举的关联值是实际值，并不是原始值的另一种表达方法。实际上，如果没有比较有意义的原始值，你就不需要提供原始值。
```swift ```swift
enum Suit { enum Suit {
case Spades, Hearts, Diamonds, Clubs case spades, hearts, diamonds, clubs
func simpleDescription() -> String { func simpleDescription() -> String {
switch self { switch self {
case .Spades: case .spades:
return "spades" return "spades"
case .Hearts: case .hearts:
return "hearts" return "hearts"
case .Diamonds: case .diamonds:
return "diamonds" return "diamonds"
case .Clubs: case .clubs:
return "clubs" return "clubs"
} }
} }
} }
let hearts = Suit.Hearts let hearts = Suit.hearts
let heartsDescription = hearts.simpleDescription() let heartsDescription = hearts.simpleDescription()
``` ```
> 练习： > 练习：
> 给 `Suit` 添加一个 `color()` 方法，对 `spades` 和 `clubs` 返回 “black” ，对 `hearts` 和 `diamonds` 返回 “red” 。 > 给 `Suit` 添加一个 `color()` 方法，对 `spades` 和 `clubs` 返回 “black” ，对 `hearts` 和 `diamonds` 返回 “red” 。
注意，有两种方式可以引用`Hearts`成员：给`hearts`常量赋值时，枚举成员`Suit.Hearts`需要用全名来引用，因为常量没有显式指定类型。在`switch`里，枚举成员使用缩写`.Hearts`来引用，因为`self`的值已经知道是一个`suit`。已知变量类型的情况下你可以使用缩写。 注意在上面的例子中用了两种方式引用 `hearts` 枚举成员：给 `hearts` 常量赋值时，枚举成员 `Suit.hearts` 需要用全名来引用，因为常量没有显式指定类型。在 `switch` 里，枚举成员使用缩写 `.hearts` 来引用，因为 `self` 已经是一个 `suit` 类型，在已知变量类型的情况下可以使用缩写。
如果枚举成员的实例有原始值，那么这些值是在声明的时候就已经决定了，这意味着不同的枚举成员总会有一个相同的原始值。当然我们也可以为枚举成员设定关联值，关联值是在创建实例时决定的。这意味着不同的枚举成员的关联值都可以不同。你可以把关联值想象成枚举成员的寄存属性。例如，考虑从服务器获取日出和日落的时间。服务器会返回正常结果或者错误信息。
一个枚举成员的实例可以有实例值。相同枚举成员的实例可以有不同的值。创建实例的时候传入值即可。实例值和原始值是不同的：枚举成员的原始值对于所有实例都是相同的，而且你是在定义枚举的时候设置原始值。
例如，考虑从服务器获取日出和日落的时间。服务器会返回正常结果或者错误信息。
```swift ```swift
enum ServerResponse { enum ServerResponse {
case Result(String, String) case result(String, String)
case Failure(String) case failure(String)
} }
let success = ServerResponse.Result("6:00 am", "8:09 pm") let success = ServerResponse.result("6:00 am", "8:09 pm")
let failure = ServerResponse.Failure("Out of cheese.") let failure = ServerResponse.failure("Out of cheese.")
switch success { switch success {
case let .Result(sunrise, sunset): case let .result(sunrise, sunset):
let serverResponse = "Sunrise is at \(sunrise) and sunset is at \(sunset)." print("Sunrise is at \(sunrise) and sunset is at \(sunset)")
case let .Failure(message): case let .failure(message):
print("Failure... \(message)") print("Failure... \(message)")
} }
``` ```
> 练习： > 练习：
> 给`ServerResponse`和`switch`添加第三种情况。 > 给`ServerResponse`和 switch 添加第三种情况。
注意日升和日落时间是如何从 `ServerResponse` 中提取到并与 `switch` 的 `case` 相匹配的。 注意日升和日落时间是如何从 `ServerResponse` 中提取到并与 `switch` 的 `case` 相匹配的。
@ -628,7 +623,7 @@ struct Card {
return "The \(rank.simpleDescription()) of \(suit.simpleDescription())" return "The \(rank.simpleDescription()) of \(suit.simpleDescription())"
} }
} }
let threeOfSpades = Card(rank: .Three, suit: .Spades) let threeOfSpades = Card(rank: .three, suit: .spades)
let threeOfSpadesDescription = threeOfSpades.simpleDescription() let threeOfSpadesDescription = threeOfSpades.simpleDescription()
``` ```
@ -678,7 +673,7 @@ let bDescription = b.simpleDescription
注意声明`SimpleStructure`时候`mutating`关键字用来标记一个会修改结构体的方法。`SimpleClass`的声明不需要标记任何方法，因为类中的方法通常可以修改类属性（类的性质）。 注意声明`SimpleStructure`时候`mutating`关键字用来标记一个会修改结构体的方法。`SimpleClass`的声明不需要标记任何方法，因为类中的方法通常可以修改类属性（类的性质）。
使用`extension`来为现有的类型添加功能，比如新的方法和计算属性。你可以使用扩展在别处修改定义，甚至是从外部库或者框架引入的一个类型，使得这个类型遵循某个协议。 使用`extension`来为现有的类型添加功能，比如新的方法和计算属性。你可以使用扩展让某个在别处声明的类型来遵守某个协议，这同样适用于从外部库或者框架引入的类型。
```swift ```swift
extension Int: ExampleProtocol { extension Int: ExampleProtocol {
@ -703,7 +698,7 @@ print(protocolValue.simpleDescription)
// print(protocolValue.anotherProperty) // 去掉注释可以看到错误 // print(protocolValue.anotherProperty) // 去掉注释可以看到错误
``` ```
即使`protocolValue`变量运行时的类型是`simpleClass`，编译器会把它的类型当做`ExampleProtocol`。这表示你不能调用类在它实现的协议之外实现的方法或者属性。 即使 `protocolValue` 变量运行时的类型是 `simpleClass` ，编译器还是会把它的类型当做`ExampleProtocol`。这表示你不能调用在协议之外的方法或者属性。
<a name="error_handling"></a> <a name="error_handling"></a>
## 错误处理 ## 错误处理
@ -835,4 +830,4 @@ anyCommonElements([1, 2, 3], [3])
> 练习： > 练习：
> 修改 `anyCommonElements(_:_:)` 函数来创建一个函数，返回一个数组，内容是两个序列的共有元素。 > 修改 `anyCommonElements(_:_:)` 函数来创建一个函数，返回一个数组，内容是两个序列的共有元素。
`<T: Equatable>`和` <T> ... where T: Equatable>`是等价的。 `<T: Equatable>` 和 `<T> ... where T: Equatable>` 的写法是等价的。