Merge pull request #521 from 949478479/gh-pages

校对
This commit is contained in:
梁杰
2015-11-03 18:11:11 +08:00

View File

@ -15,18 +15,18 @@
本页内容包含:
- [枚举语法Enumeration Syntax](#enumeration_syntax)
- [匹配枚举值与`Swith`语句Matching Enumeration Values with a Switch Statement](#matching_enumeration_values_with_a_switch_statement)
- [关值Associated Values](#associated_values)
- [使用 Switch 语句匹配枚举值Matching Enumeration Values with a Switch Statement](#matching_enumeration_values_with_a_switch_statement)
- [Associated Values](#associated_values)
- [原始值Raw Values](#raw_values)
- [递归枚举Recursive Enumerations](#recursive_enumerations)
**枚举**定义了一个通用类型的一组相关值,使你可以在你的代码中以一种安全的方式来使用这些值。
*枚举*为一组相关的值定义了一个共同的类型,使你可以在你的代码中以类型安全的方式来使用这些值。
如果你熟悉 C 语言,你会知道在 C 语言中枚举将枚举名和一个整型值相对应。Swift 中的枚举更加灵活,不必给每一个枚举成员提供一个值。如果给枚举成员提供一个值(称为“原始”值),则该值的类型可以是字符串,字符,或是一个整型值或浮点数。
如果你熟悉 C 语言,你会知道在 C 语言中枚举会为一组整型值分配相关联的名称。Swift 中的枚举更加灵活,不必给每一个枚举成员提供一个值。如果给枚举成员提供一个值(称为“原始”值),则该值的类型可以是字符串,字符,或是一个整型值或浮点数。
此外,枚举成员可以指定任类型的关值存储到枚举成员就像其他语言中的联合体unions和变体variants你可以定义一组通用的相关成员作为枚举的一部分,每一组都有不同的一组与它相关的适当类型的值。
此外,枚举成员可以指定任类型的关值存储到枚举成员中就像其他语言中的联合体unions和变体variants每一个枚举成员都可以有适当类型的关联值。
在 Swift 中,枚举类型是一等公民first-class。它们采用了很多传统上只被类class所支持的特例如计算型属性computed properties用于提供关于枚举当前值的附加信息实例方法instance methods用于提供和枚举所代表的值相关联的功能。枚举也可以定义构造函数initializers来提供一个初始值可以在原始实现基础上扩展它们的功能可以遵守协议protocols来提供标准的功能。
在 Swift 中枚举类型是一等first-class类型。它们采用了很多传统上只被类class所支持的特例如计算型属性computed properties用于提供枚举值的附加信息实例方法instance methods用于提供和枚举值相关联的功能。枚举也可以定义构造函数initializers来提供一个初始值可以在原始实现基础上扩展它们的功能;可以遵守协议protocols来提供标准的功能。
欲了解更多相关信息,请参见[属性Properties](./10_Properties.html)[方法Methods](./11_Methods.html)[构造过程Initialization](./14_Initialization.html)[扩展Extensions](./21_Extensions.html)和[协议Protocols](./22_Protocols.html)。
@ -41,7 +41,7 @@ enum SomeEnumeration {
}
```
下面是指南针四个方向的例子:
下面是用枚举表示指南针四个方向的例子:
```swift
enum CompassPoint {
@ -52,10 +52,10 @@ enum CompassPoint {
}
```
枚举中定义的值(如 `North``South``East``West`)是这个枚举的**成员值**(或**成员**)。`case`关键词表示一行新的成员值将被定义
枚举中定义的值(如 `North``South``East``West`)是这个枚举的*成员值*(或*成员*)。你使用`case`关键字来定义一个新的枚举成员值
> 注意
> C 和 Objective-C 不同Swift 的枚举成员在被创建时不会被赋予一个默认的整型值。在上面的`CompassPoint`例子中,`North``South``East`和`West`不会隐式地赋值为`0``1``2`和`3`。相反,这些枚举成员本身就完备的值,这些值是已经明确定义好的`CompassPoint`类型。
> 注意
> C 和 Objective-C 不同Swift 的枚举成员在被创建时不会被赋予一个默认的整型值。在上面的`CompassPoint`例子中,`North``South``East`和`West`不会隐式地赋值为`0``1``2`和`3`。相反,这些枚举成员本身就完备的值,这些值的类型是已经明确定义好的`CompassPoint`类型。
多个成员值可以出现在同一行上,用逗号隔开:
@ -71,16 +71,16 @@ enum Planet {
var directionToHead = CompassPoint.West
```
`directionToHead`的类型可以在它被`CompassPoint`一个可能值初始化时推断出来。一旦`directionToHead`被声明为一个`CompassPoint`,你可以使用一个缩写语法(.将其设置为另一个`CompassPoint`的值:
`directionToHead`的类型可以在它被`CompassPoint`某个值初始化时推断出来。一旦`directionToHead`被声明为`CompassPoint`类型,你可以使用更短的点语法将其设置为另一个`CompassPoint`的值:
```swift
directionToHead = .East
```
`directionToHead`的类型已知时,再次为其赋值可以省略枚举名。使用显式类型的枚举值可以让代码具有更好的可读性。
`directionToHead`的类型已知时,再次为其赋值可以省略枚举类型名。使用具有显式类型的枚举值时,这种写法让代码具有更好的可读性。
<a name="matching_enumeration_values_with_a_switch_statement"></a>
## 匹配枚举值和`Switch`语句
## 使用 Switch 语句匹配枚举值
你可以使用`switch`语句匹配单个枚举值:
@ -103,11 +103,11 @@ switch directionToHead {
“判断`directionToHead`的值。当它等于`.North`,打印`“Lots of planets have a north”`。当它等于`.South`,打印`“Watch out for penguins”`。”
等等以此类推。
……以此类推。
正如在[控制流Control Flow](./05_Control_Flow.html)中介绍的那样,在判断一个枚举类型的值时,`switch`语句必须穷举所有情况。如果忽略了`.West`这种情况,上面那段代码将无法通过编译,因为它没有考虑到`CompassPoint`的全部成员。强制性全部穷举的要求确保了枚举成员不会被意外遗漏。
正如在[控制流Control Flow](./05_Control_Flow.html)中介绍的那样,在判断一个枚举类型的值时,`switch`语句必须穷举所有情况。如果忽略了`.West`这种情况,上面那段代码将无法通过编译,因为它没有考虑到`CompassPoint`的全部成员。强制穷举确保了枚举成员不会被意外遗漏。
当不需要匹配每个枚举成员的时候,你可以提供一个默认`default`分支来涵盖所有未明确被提出的枚举成员:
当不需要匹配每个枚举成员的时候,你可以提供一个`default`分支来涵盖所有未明确处理的枚举成员:
```swift
let somePlanet = Planet.Earth
@ -121,23 +121,23 @@ default:
```
<a name="associated_values"></a>
## 关值Associated Values
## 关Associated Values
上一小节的例子演示了如何定义分类枚举的成员。你可以为`Planet.Earth`设置一个常量或者变量,并在赋值之后查看这个值。不管怎样,如果有时候能够把其他类型的**相关值**和成员值一起存储起来会很有用。这能让你存储成员值外的自定义信息,并且你每次在代码中使用该成员时允许这个信息产生变化
上一小节的例子演示了如何定义分类枚举的成员。你可以为`Planet.Earth`设置一个常量或者变量,并在赋值之后查看这个值。然而,有时候能够把其他类型的*关联值*和成员值一起存储起来会很有用。这能让你连同成员值一起存储额外的自定义信息,并且你每次在代码中使用该枚举成员时,还可以修改这个关联值
你可以定义 Swift 枚举存储任类型的关值,如果需要的话,每个成员的数据类型可以各不相同。枚举的这种特性跟其他语言中的可识联合discriminated unions标签联合tagged unions或者变体variants相似。
你可以定义 Swift 枚举存储任类型的关值,如果需要的话,每个枚举成员的关联值类型可以各不相同。枚举的这种特性跟其他语言中的可识联合discriminated unions标签联合tagged unions或者变体variants相似。
例如,假设一个库存跟踪系统需要利用两种不同类型的条形码来跟踪商品。有些商品上标有 UPC-A 格式的一维条形码,它使用数字 0 到 9。每一个条形码都有一个代表“数字系统”的数字,该数字后接 5 个代表“生产代码”的数字,接下来是5位“产品代码”。最后一个数字是“检查”位,用来验证代码是否被正确扫描:
例如,假设一个库存跟踪系统需要利用两种不同类型的条形码来跟踪商品。有些商品上标有使用`0``9`的数字的 UPC-A 格式的一维条形码。每一个条形码都有一个代表“数字系统”的数字,该数字后接五位代表“厂商代码”的数字,接下来是五位代表“产品代码”的数字。最后一个数字是“检查”位,用来验证代码是否被正确扫描:
<img width="252" height="120" alt="" src="https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/Art/barcode_UPC_2x.png">
其他商品上标有 QR 码格式的二维码,它可以使用任何 ISO 8859-1 字符,并且可以编码一个最多拥有 2953 个字符的字符串:
其他商品上标有 QR 码格式的二维码,它可以使用任何 ISO 8859-1 字符,并且可以编码一个最多拥有 2,953 个字符的字符串
<img width="169" height="169" alt="" src="https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/Art/barcode_QR_2x.png">
于库存跟踪系统来说,能够把 UPC-A 码作为四个整型值的元组,和把 QR 码作为一个任何长度的字符串存储起来是方便的
这便于库存跟踪系统用包含四个整型值的元组存储 UPC-A 码,以及用任意长度的字符串储存 QR 码
在 Swift 中,使用如下方式定义两种商品条码的枚举:
在 Swift 中,使用如下方式定义表示两种商品条码的枚举:
```swift
enum Barcode {
@ -148,27 +148,27 @@ enum Barcode {
以上代码可以这么理解:
“定义一个名为`Barcode`的枚举类型,它可以是`UPCA`的一个相关值(`Int``Int``Int``Int`),或者是`QRCode`的一个字符串类型(`String`)相关值。”
“定义一个名为`Barcode`的枚举类型,它的一个成员值是具有`(IntIntIntInt)`类型关联值的`UPCA`,另一个成员值是具有`String`类型关联值的`QRCode`。”
这个定义不提供任何`Int``String`的实际值,它只是定义了,当`Barcode`常量和变量等于`Barcode.UPCA``Barcode.QRCode`时,相关值的类型。
这个定义不提供任何`Int``String`类型的关联值,它只是定义了,当`Barcode`常量和变量等于`Barcode.UPCA``Barcode.QRCode`时,可以存储的关联值的类型。
然后可以使用任一种条码类型创建新的条码,如:
然后可以使用任一种条码类型创建新的条码,如:
```swift
var productBarcode = Barcode.UPCA(8, 85909, 51226, 3)
```
上例子创建了一个名为`productBarcode`的变量,并且赋给它一个`Barcode.UPCA`相关元组值`(8, 85909, 51226, 3)`
面的例子创建了一个名为`productBarcode`的变量,并`Barcode.UPCA`赋值给它,关联的元组值`(8, 85909, 51226, 3)`
同一个商品可以被分配一个不同类型的条形码,如:
同一个商品可以被分配一个不同类型的条形码,如:
```swift
productBarcode = .QRCode("ABCDEFGHIJKLMNOP")
```
这时,原始的`Barcode.UPCA`和其整数值被新的`Barcode.QRCode`和其字符串值所替代。条形码的常量和变量可以存储一个`.UPCA`或者一个`.QRCode`(连同它的相关值),但是在任何指定时间只能存储其中之一
这时,原始的`Barcode.UPCA`和其整数关联值被新的`Barcode.QRCode`和其字符串关联值所替代。`Barcode`类型的常量和变量可以存储一个`.UPCA`或者一个`.QRCode`(连同它们的关联值),但是在同一时间只能存储这两个值中的一个
前那样,不同的条形码类型可以使用一个 switch 语句来检查,然而这次相关值可以被提取作为 switch 语句的一部分。你可以在`switch`的 case 分支代码中提取每个关值作为一个常量(用`let`前缀)或者作为一个变量(用`var`前缀)来使用:
前那样,可以使用一个 switch 语句来检查不同的条形码类型。然而,这一次,关联值可以被提取出来作为 switch 语句的一部分。你可以在`switch`的 case 分支代码中提取每个关值作为一个常量(用`let`前缀)或者作为一个变量(用`var`前缀)来使用:
```swift
switch productBarcode {
@ -180,7 +180,7 @@ case .QRCode(let productCode):
// 输出 "QR code: ABCDEFGHIJKLMNOP."
```
如果一个枚举成员的所有相关值被提取为常量,或者它们全部被提取为变量,为了简洁,你可以只放置一个`var`或者`let`标注在成员名称前
如果一个枚举成员的所有关联值都被提取为常量,或者被提取为变量,为了简洁,你可以只在成员名称前标注一个`let`或者`var`
```swift
switch productBarcode {
@ -195,9 +195,9 @@ case let .QRCode(productCode):
<a name="raw_values"></a>
## 原始值Raw Values
在[关值](#raw_values)小节的条形码例子中演示了一个枚举的成员如何声明它们存储不同类型的相关值。作为相关值的另一种选择,枚举成员可以被默认值(称为原始值)赋值,其中这些原始值具有相同的类型
在[](#associated_values)小节的条形码例子中演示了如何声明存储不同类型关联值的枚举成员。作为关联值的替代选择,枚举成员可以被默认值(称为*原始值*)预填充,这些原始值的类型必须相同
是一个枚举成员存储 ASCII 码的例子
这是一个使用 ASCII 码作为原始值的枚举
```swift
enum ASCIIControlCharacter: Character {
@ -207,23 +207,22 @@ enum ASCIIControlCharacter: Character {
}
```
在这里,`ASCIIControlCharacter`枚举类型的原始值类型被定义为字符型`Character`,并设置了一些比较常见的 ASCII 控制字符。字符值的描述详见[字符串和字符](./03_Strings_and_Characters.html)部分。
枚举类型`ASCIIControlCharacter`的原始值类型被定义为`Character`,并设置了一些比较常见的 ASCII 控制字符。`Character`的描述详见[字符串和字符](./03_Strings_and_Characters.html)部分。
原始值可以是字符串,字符,或者任整型值或浮点型值。每个原始值在它的枚举声明中必须是唯一的。
>注意:
>原始值和相关值是不相同的。当你开始在你的代码中定义枚举的时候原始值是被预先填充的值,像上述三个 ASCII 码。对于一个特定的枚举成员,它的原始值始终是相同的。相关值是当你在创建一个基于枚举成员的新常量或变量时才会被设置,并且每次当你这么做得时候,它的值可以是不同的。
原始值可以是字符串,字符,或者任整型值或浮点型值。每个原始值在枚举声明中必须是唯一的。
> 注意
> 原始值和关联值是不同的。原始值是在定义枚举时被预先填充的值,像上述三个 ASCII 码。对于一个特定的枚举成员,它的原始值始终不变。关联值是创建一个基于枚举成员的常量或变量时才设置的值,枚举成员的关联值可以变化。
<a name="implicitly_assigned_raw_values"></a>
### 原始值的隐式赋值Implicitly Assigned Raw Values
在使用原始值为整数或者字符串类型的枚举时,不需要显式为每一个成员赋值,这时Swift将会自动为你赋值。
在使用原始值为整数或者字符串类型的枚举时,不需要显式为每一个枚举成员设置原始值Swift 将会自动为你赋值。
例如,当使用整数作为原始值时,隐式赋值的值依次递增1。如果第一个值没有被赋初值将会被自动置为0
例如,当使用整数作为原始值时,隐式赋值的值依次递增`1`。如果第一个枚举成员没有设置原始值,其原始值将为`0`
下面的枚举是对之前`Planet`这个枚举的一个细化,利用原始整型值来表示每个 planet 在太阳系中的顺序:
下面的枚举是对之前`Planet`这个枚举的一个细化,利用整型的原始值来表示每个行星在太阳系中的顺序:
```swift
enum Planet: Int {
@ -231,11 +230,11 @@ enum Planet: Int {
}
```
在上面的例子中,`Plant.Mercury`赋了初值`1``Planet.Venus`会拥有隐式赋值`2`,依次类推。
在上面的例子中,`Plant.Mercury`的显式原始值为`1``Planet.Venus`的隐式原始值为`2`,依次类推。
当使用字符串作为枚举类型的值时,每个枚举成员的隐式初值则为该成员的名称。
当使用字符串作为枚举类型的原始值时,每个枚举成员的隐式原始值为该枚举成员的名称。
下面的例子是`CompassPoint`枚举类型的精简版,使用字符串作为初值类型,隐式初始化为各个方向的名称:
下面的例子是`CompassPoint`枚举的细化,使用字符串类型的原始值来表示各个方向的名称:
```swift
enum CompassPoint: String {
@ -243,7 +242,7 @@ enum CompassPoint: String {
}
```
上面例子中,`CompassPoint.South`拥有隐式`South`,依次类推。
上面例子中,`CompassPoint.South`拥有隐式原始`South`,依次类推。
使用枚举成员的`rawValue`属性可以访问该枚举成员的原始值:
@ -256,23 +255,23 @@ let sunsetDirection = CompassPoint.West.rawValue
```
<a name="initializing_from_a_raw_value"></a>
### 使用原始值初始化枚举变量Initializing from a Raw Value
### 使用原始值初始化枚举实例Initializing from a Raw Value
如果在定义枚举类型的时候使用了原始值,那么将会自动获得一个初始化方法,这个方法原始值类型作为参数,返回值是枚举成员或`nil`。你可以使用这初始化方法来创建一个新的枚举变量
如果在定义枚举类型的时候使用了原始值,那么将会自动获得一个初始化方法,这个方法接收一个叫做`rawValue`的参数,参数类型即为原始值类型,返回值是枚举成员或`nil`。你可以使用这初始化方法来创建一个新的枚举实例
这个例子通过原始值`7`从而创建枚举成员:
这个例子利用原始值`7`创建枚举成员`Uranus`
```swift
let possiblePlanet = Planet(rawValue: 7)
// possiblePlanet 类型为 Planet? 值为 Planet.Uranus
```
然而,并非所有可能的`Int`值都可以找到一个匹配的行星。正因为如此,构造函数可以返回一个**可选**的枚举成员。在上面的例子中,`possiblePlanet``Planet?`类型,或“可选的`Planet`”。
然而,并非所有`Int`值都可以找到一个匹配的行星。因此,原始值构造器总是返回一个*可选*的枚举成员。在上面的例子中,`possiblePlanet``Planet?`类型,或者说“可选的`Planet`”。
>注意:
>原始值构造器是一个可失败构造器,因为并不是每一个原始值都有与之对应的枚举成员。更多信息请参见[可失败构造器](../chapter3/05_Declarations.html#failable_initializers)
> 注意
> 原始值构造器是一个可失败构造器,因为并不是每一个原始值都有与之对应的枚举成员。更多信息请参见[可失败构造器](../chapter3/05_Declarations.html#failable_initializers)
如果你试图寻找一个位置为9的行星,通过参数为`rawValue`构造函数返回的可选`Planet`值将是`nil`
如果你试图寻找一个位置为`9`的行星,通过原始值构造器返回的可选`Planet`值将是`nil`
```swift
let positionToFind = 9
@ -289,19 +288,18 @@ if let somePlanet = Planet(rawValue: positionToFind) {
// 输出 "There isn't a planet at position 9
```
这个例使用可选绑定optional binding通过原始值`9`试图访问一个行星。`if let somePlanet = Planet(rawValue: 9)`语句获得一个可选`Planet`,如果可选`Planet`可以被获得,把`somePlanet`设置成该可选`Planet`的内容。在这个例中,无法检索到位置为`9`的行星,所以`else`分支被执行。
这个例使用可选绑定optional binding试图通过原始值`9`访问一个行星。`if let somePlanet = Planet(rawValue: 9)`语句创建了一个可选`Planet`,如果可选`Planet`的值存在,就会赋值给`somePlanet`。在这个例中,无法检索到位置为`9`的行星,所以`else`分支被执行。
<a name="recursive_enumerations"></a>
## 递归枚举Recursive Enumerations
在对操作符进行描述的时候,使用枚举类型来对数据建模很方便,因为需要考虑的情况固定可枚举。操作符可以将两个由数字组成的算表达式连接起来,例如,将`5`连接成复杂一些的表达式`5+4`
当各种可能的情况可以被穷举时,非常适合使用枚举进行数据建模,例如可以用枚举来表示用于简单整数运算的操作符。这些操作符让你可以将简单的算表达式,例如整数`5`,结合为更为复杂的表达式,例如`5 + 4`
算术表达式的一个重要特性是,表达式可以嵌套使用。例如,表达式`(5 + 4) * 2`乘号右边是一个数字,左边则是另一个表达式。因为数据是嵌套的,因而用来存储数据的枚举类型也要支持这种嵌套————这表示枚举类型需要支持递归。
算术表达式的一个重要特性是,表达式可以嵌套使用。例如,表达式`(5 + 4) * 2`乘号右边是一个数字,左边则是另一个表达式。因为数据是嵌套的,因而用来存储数据的枚举类型也要支持这种嵌套——这意味着枚举类型需要支持递归。
`递归枚举recursive enumeration`是一种枚举类型,表示它的枚举中,有一个或多个枚举成员拥有该枚举的其他成员作为相关值。使用递归枚举时,编译器会插入一个间层。你可以在枚举成员前加上`indirect`来表示成员可递归。
例如,下面的例子中,枚举类型存储了简单的算数表达式:
*递归枚举recursive enumeration*是一种枚举类型,有一个或多个枚举成员使用该枚举类型的实例作为关联值。使用递归枚举时,编译器会插入一个间层。你可以在枚举成员前加上`indirect`来表示成员可递归。
例如,下面的例子中,枚举类型存储了简单的算术表达式:
```swift
enum ArithmeticExpression {
@ -311,7 +309,7 @@ enum ArithmeticExpression {
}
```
你也可以在枚举类型开头加上`indirect`关键字来表它的所有成员都是可递归的:
你也可以在枚举类型开头加上`indirect`关键字来表它的所有成员都是可递归的:
```swift
indirect enum ArithmeticExpression {
@ -321,9 +319,9 @@ indirect enum ArithmeticExpression {
}
```
上面定义的枚举类型可以存储三种算表达式:纯数字、两个表达式相加、两个表达式相乘。`Addition``Multiplication`成员的相关值也是算表达式————这些相关值使得嵌套表达式成为可能。
上面定义的枚举类型可以存储三种算表达式:纯数字、两个表达式相加、两个表达式相乘。枚举成员`Addition``Multiplication`的关联值也是算表达式——这些关联值使得嵌套表达式成为可能。
递归函数可以很直观地使用具有递归性质的数据结构。例如,下面是一个计算算术表达式的函数:
要操作具有递归性质的数据结构,使用递归函数是一种直截了当的方式。例如,下面是一个算术表达式求值的函数:
```swift
func evaluate(expression: ArithmeticExpression) -> Int {