diff --git a/source/chapter2/23_Generics.md b/source/chapter2/23_Generics.md index 03633c0b..2b0e982f 100644 --- a/source/chapter2/23_Generics.md +++ b/source/chapter2/23_Generics.md @@ -1,4 +1,4 @@ -# 泛型（Generics） +# 泛型 ------ @@ -14,7 +14,8 @@ > 2.2：翻译+校对：[Lanford](https://github.com/LanfordCai)，2016-04-08 [SketchK](https://github.com/SketchK) 2016-05-16 -> 3.0：翻译+校对：[chenmingjia](https://github.com/chenmingjia)，2016-09-12 +> 3.0：翻译+校对：[chenmingjia](https://github.com/chenmingjia)，2016-09-12 +> 3.0.1，shanks，2016-11-13 本页包含内容： @@ -26,9 +27,9 @@ - [扩展一个泛型类型](#extending_a_generic_type) - [类型约束](#type_constraints) - [关联类型](#associated_types) -- [Where 子句](#where_clauses) +- [泛型 Where 语句](#where_clauses) -泛型代码让你能够根据自定义的需求，编写出适用于任意类型、灵活可重用的函数及类型。它能让你避免代码的重复，用一种清晰和抽象的方式来表达代码的意图。 +*泛型代码*让你能够根据自定义的需求，编写出适用于任意类型、灵活可重用的函数及类型。它能让你避免代码的重复，用一种清晰和抽象的方式来表达代码的意图。 泛型是 Swift 最强大的特性之一，许多 Swift 标准库是通过泛型代码构建的。事实上，泛型的使用贯穿了整本语言手册，只是你可能没有发现而已。例如，Swift 的 `Array` 和 `Dictionary` 都是泛型集合。你可以创建一个 `Int` 数组，也可创建一个 `String` 数组，甚至可以是任意其他 Swift 类型的数组。同样的，你也可以创建存储任意指定类型的字典。 @@ -38,7 +39,7 @@ 下面是一个标准的非泛型函数 `swapTwoInts(_:_:)`，用来交换两个 `Int` 值： ```swift -func swapTwoInts(inout a: Int, inout _ b: Int) { +func swapTwoInts(_ a: inout Int, _ b: inout Int) { let temporaryA = a a = b b = temporaryA @@ -60,13 +61,13 @@ print("someInt is now \(someInt), and anotherInt is now \(anotherInt)") 诚然，`swapTwoInts(_:_:)` 函数挺有用，但是它只能交换 `Int` 值，如果你想要交换两个 `String` 值或者 `Double`值，就不得不写更多的函数，例如 `swapTwoStrings(_:_:)` 和 `swapTwoDoubles(_:_:)`，如下所示： ```swift -func swapTwoStrings(inout a: String, inout _ b: String) { +func swapTwoStrings(_ a: inout String, _ b: inout String) { let temporaryA = a a = b b = temporaryA } - -func swapTwoDoubles(inout a: Double, inout _ b: Double) { + +func swapTwoDoubles(_ a: inout Double, _ b: inout Double) { let temporaryA = a a = b b = temporaryA @@ -86,18 +87,19 @@ func swapTwoDoubles(inout a: Double, inout _ b: Double) { 泛型函数可以适用于任何类型，下面的 `swapTwoValues(_:_:)` 函数是上面三个函数的泛型版本： ```swift -func swapTwoValues(inout a: T, inout _ b: T) { +func swapTwoValues(_ a: inout T, _ b: inout T) { let temporaryA = a a = b b = temporaryA } + ``` `swapTwoValues(_:_:)` 的函数主体和 `swapTwoInts(_:_:)` 函数是一样的，它们只在第一行有点不同，如下所示： ```swift -func swapTwoInts(inout a: Int, inout _ b: Int) -func swapTwoValues(inout a: T, inout _ b: T) +func swapTwoInts(_ a: inout Int, _ b: inout Int) +func swapTwoValues(_ a: inout T, _ b: inout T) ``` 这个函数的泛型版本使用了占位类型名（在这里用字母 `T` 来表示）来代替实际类型名（例如 `Int`、`String` 或 `Double`）。占位类型名没有指明 `T` 必须是什么类型，但是它指明了 `a` 和 `b` 必须是同一类型 `T`，无论 `T` 代表什么类型。只有 `swapTwoValues(_:_:)` 函数在调用时，才能根据所传入的实际类型决定 `T` 所代表的类型。 @@ -112,12 +114,12 @@ func swapTwoValues(inout a: T, inout _ b: T) var someInt = 3 var anotherInt = 107 swapTwoValues(&someInt, &anotherInt) -// someInt is now 107, and anotherInt is now 3 +// someInt 现在 107, and anotherInt 现在 3 var someString = "hello" var anotherString = "world" swapTwoValues(&someString, &anotherString) -// someString is now "world", and anotherString is now "hello" +// someString 现在 "world", and anotherString 现在 "hello" ``` > 注意 @@ -145,7 +147,7 @@ swapTwoValues(&someString, &anotherString) 除了泛型函数，Swift 还允许你定义泛型类型。这些自定义类、结构体和枚举可以适用于任何类型，类似于 `Array` 和 `Dictionary`。 -这部分内容将向你展示如何编写一个名为 `Stack` （栈）的泛型集合类型。栈是一系列值的有序集合，和 `Array` 类似，但它相比 Swift 的 `Array` 类型有更多的操作限制。数组允许在数组的任意位置插入新元素或是删除其中任意位置的元素。而栈只允许在集合的末端添加新的元素（称之为入栈）。类似的，栈也只能从末端移除元素（称之为出栈）。 +这部分内容将向你展示如何编写一个名为 `Stack` （栈）的泛型集合类型。栈是一系列值的有序集合，和 `Array` 类似，但它相比 Swift 的 `Array` 类型有更多的操作限制。数组允许在数组的任意位置插入新元素或是删除其中任意位置的元素。而栈只允许在集合的末端添加新的元素（称之为入*栈*）。类似的，栈也只能从末端移除元素（称之为*出*栈）。 > 注意 栈的概念已被 `UINavigationController` 类用来构造视图控制器的导航结构。你通过调用 `UINavigationController` 的 `pushViewController(_:animated:)` 方法来添加新的视图控制器到导航栈，通过 `popViewControllerAnimated(_:)` 方法来从导航栈中移除视图控制器。每当你需要一个严格的“后进先出”方式来管理集合，栈都是最实用的模型。 @@ -165,7 +167,7 @@ swapTwoValues(&someString, &anotherString) ```swift struct IntStack { var items = [Int]() - mutating func push(item: Int) { + mutating func push(_ item: Int) { items.append(item) } mutating func pop() -> Int { @@ -176,7 +178,7 @@ struct IntStack { 这个结构体在栈中使用一个名为 `items` 的 `Array` 属性来存储值。`Stack` 提供了两个方法：`push(_:)` 和 `pop()`，用来向栈中压入值以及从栈中移除值。这些方法被标记为 `mutating`，因为它们需要修改结构体的 `items` 数组。 -上面的 `IntStack` 结构体只能用于 `Int` 类型。不过，可以定义一个泛型 `Stack` 结构体，从而能够处理任意类型的值。 +上面的 `IntStack` 结构体只能用于 `Int` 类型。不过，可以定义一个泛型 `Stack` 结构体，从而能够处理*任意*类型的值。 下面是相同代码的泛型版本： @@ -283,11 +285,11 @@ func someFunction(someT: T, someU: U) { ### 类型约束实践 -这里有个名为 `findStringIndex` 的非泛型函数，该函数的功能是在一个 `String` 数组中查找给定 `String` 值的索引。若查找到匹配的字符串，`findStringIndex(_:_:)` 函数返回该字符串在数组中的索引值，否则返回 `nil`： +这里有个名为 `findIndex(ofString:in:)` 的非泛型函数，该函数的功能是在一个 `String` 数组中查找给定 `String` 值的索引。若查找到匹配的字符串，` findIndex(ofString:in:)` 函数返回该字符串在数组中的索引值，否则返回 `nil`： ```swift -func findStringIndex(array: [String], _ valueToFind: String) -> Int? { - for (index, value) in array.enumerate() { +func findIndex(ofString valueToFind: String, in array: [String]) -> Int? { + for (index, value) in array.enumerated() { if value == valueToFind { return index } @@ -296,11 +298,11 @@ func findStringIndex(array: [String], _ valueToFind: String) -> Int? { } ``` -`findStringIndex(_:_:)` 函数可以用于查找字符串数组中的某个字符串： +`findIndex(ofString:in:)` 函数可以用于查找字符串数组中的某个字符串： ```swift let strings = ["cat", "dog", "llama", "parakeet", "terrapin"] -if let foundIndex = findStringIndex(strings, "llama") { +if let foundIndex = findIndex(ofString: "llama", in: strings) { print("The index of llama is \(foundIndex)") } // 打印 “The index of llama is 2” @@ -308,11 +310,11 @@ if let foundIndex = findStringIndex(strings, "llama") { 如果只能查找字符串在数组中的索引，用处不是很大。不过，你可以用占位类型 `T` 替换 `String` 类型来写出具有相同功能的泛型函数 `findIndex(_:_:)`。 -下面展示了 `findStringIndex(_:_:)` 函数的泛型版本 `findIndex(_:_:)`。请注意这个函数返回值的类型仍然是 `Int?`，这是因为函数返回的是一个可选的索引数，而不是从数组中得到的一个可选值。需要提醒的是，这个函数无法通过编译，原因会在例子后面说明： +下面展示了 `findIndex(ofString:in:)` 函数的泛型版本 `findIndex(ofString:in:)`。请注意这个函数返回值的类型仍然是 `Int?`，这是因为函数返回的是一个可选的索引数，而不是从数组中得到的一个可选值。需要提醒的是，这个函数无法通过编译，原因会在例子后面说明： ```swift -func findIndex(array: [T], _ valueToFind: T) -> Int? { - for (index, value) in array.enumerate() { +func findIndex(of valueToFind: T, in array:[T]) -> Int? { + for (index, value) in array.enumerated() { if value == valueToFind { return index } @@ -325,7 +327,7 @@ func findIndex(array: [T], _ valueToFind: T) -> Int? { 不过，所有的这些并不会让我们无从下手。Swift 标准库中定义了一个 `Equatable` 协议，该协议要求任何遵循该协议的类型必须实现等式符（`==`）及不等符(`!=`)，从而能对该类型的任意两个值进行比较。所有的 Swift 标准类型自动支持 `Equatable` 协议。 -任何 `Equatable` 类型都可以安全地使用在 `findIndex(_:_:)` 函数中，因为其保证支持等式操作符。为了说明这个事实，当你定义一个函数时，你可以定义一个 `Equatable` 类型约束作为类型参数定义的一部分： +任何 `Equatable` 类型都可以安全地使用在 `findIndex(of:in:)` 函数中，因为其保证支持等式操作符。为了说明这个事实，当你定义一个函数时，你可以定义一个 `Equatable` 类型约束作为类型参数定义的一部分： ```swift func findIndex(array: [T], _ valueToFind: T) -> Int? { @@ -338,21 +340,21 @@ func findIndex(array: [T], _ valueToFind: T) -> Int? { } ``` -`findIndex(_:_:)` 唯一的类型参数写做 `T: Equatable`，也就意味着“任何符合 `Equatable` 协议的类型 `T` ”。 +`findIndex(of:in:)` 唯一的类型参数写做 `T: Equatable`，也就意味着“任何符合 `Equatable` 协议的类型 `T` ”。 -`findIndex(_:_:)` 函数现在可以成功编译了，并且可以作用于任何符合 `Equatable` 的类型，如 `Double` 或 `String`： +`findIndex(of:in:)` 函数现在可以成功编译了，并且可以作用于任何符合 `Equatable` 的类型，如 `Double` 或 `String`： ```swift -let doubleIndex = findIndex([3.14159, 0.1, 0.25], 9.3) +let doubleIndex = findIndex(of: 9.3, in: [3.14159, 0.1, 0.25]) // doubleIndex 类型为 Int?，其值为 nil，因为 9.3 不在数组中 -let stringIndex = findIndex(["Mike", "Malcolm", "Andrea"], "Andrea") +let stringIndex = findIndex(of: "Andrea", in: ["Mike", "Malcolm", "Andrea"]) // stringIndex 类型为 Int?，其值为 2 ``` ## 关联类型 -定义一个协议时，有的时候声明一个或多个关联类型作为协议定义的一部分将会非常有用。关联类型为协议中的某个类型提供了一个占位名（或者说别名），其代表的实际类型在协议被采纳时才会被指定。你可以通过 `associatedtype` 关键字来指定关联类型。 +定义一个协议时，有的时候声明一个或多个关联类型作为协议定义的一部分将会非常有用。*关联类型*为协议中的某个类型提供了一个占位名（或者说别名），其代表的实际类型在协议被采纳时才会被指定。你可以通过 `associatedtype` 关键字来指定关联类型。 ### 关联类型实践 @@ -455,7 +457,7 @@ extension Array: Container {} 如同上面的泛型 `Stack` 结构体一样，`Array` 的 `append(_:)` 方法和下标确保了 Swift 可以推断出 `ItemType` 的类型。定义了这个扩展后，你可以将任意 `Array` 当作 `Container` 来使用。 -## Where 子句 +## 泛型 Where 语句 [类型约束](#type_constraints)让你能够为泛型函数或泛型类型的类型参数定义一些强制要求。