The Swift Programming Language-官方教程精译Swift(9) 枚举-- --Enumerations

枚举定义了一个通用类型的一组相关的值,使你可以在你的代码中以一个安全的方式来使用这些值。

如果你熟悉 C 语言,你就会知道,在 C 语言中枚举指定相关名称为一组整型值。Swift 中的枚举更加灵活,不必给每一个枚举成员(enumeration member)提供一个值。如果一个值(被认为是“原始”值)被提供给每个枚举成员,则该值可以是一个字符串,一个字符,或是一个整型值或浮点值。

此外,枚举成员可以指定任何类型的关联值存储到枚举成员值中,就像其他语言中的联合体(unions)和变体(variants)。你可以定义一组通用的相关成员作为枚举的一部分,每一组都有不同的一组与它相关的适当类型的数值。

在 Swift 中,枚举类型是一等(first-class)类型。它们采用了很多传统上只被类所支持的特征,例如计算型属性(computed properties),用于提供关于枚举当前值的附加信息,实例方法(instance methods),用于提供和枚举所代表的值相关联的功能。枚举也可以定义构造器(initializers)来提供一个初始成员值;可以在原始的实现基础上扩展它们的功能;可以遵守协议(protocols)来提供标准的功能。

欲了解更多相关功能,请参考属性,方法,构造过程,扩展,和协议。

枚举语法(Enumeration Syntax)

使用enum关键词并且把它们的整个定义放在一对大括号内:

1 enum SomeEumeration {
2     // enumeration definition goes here
3 } 

以下是指南针四个方向的一个例子:

1 enum CompassPoint {
2     case North
3     case South
4     case East
5     case West
6 } 

一个枚举中被定义的值(例如 North,South,East和West)是枚举的成员值(或者成员)。case关键词表明新的一行成员值将被定义。

注意: 不像 C 和 Objective-C 一样,Swift 的枚举成员在被创建时不会被赋予一个默认的整数值。在上面的CompassPoints例子中,North,South,East和West不是隐式得等于0,1,2和3。相反的,这些不同的枚举成员在CompassPoint的一种显示定义中拥有各自不同的值。

多个成员值可以出现在同一行上,用逗号隔开:

1 enum Planet {
2     case Mercury, Venus, Earth, Mars, Jupiter, Saturn, Uranus, Nepturn
3 } 

每个枚举定义了一个全新的类型。像 Swift 中其他类型一样,它们的名字(例如CompassPoint和Planet)必须以一个大写字母开头。给枚举类型起一个单数名字而不是复数名字,以便于读起来更加容易理解:

1 var directionToHead = CompassPoint.West 

directionToHead的类型被推断当它被CompassPoint的一个可能值初始化。一旦directionToHead被声明为一个CompassPoint,你可以使用更短的点(.)语法将其设置为另一个CompassPoint的值:

1 directionToHead = .East 

directionToHead的类型已知时,当设定它的值时,你可以不再写类型名。使用显示类型的枚举值可以让代码具有更好的可读性。

匹配枚举值和Switch语句(Matching Enumeration Values with a Switch Statement)

你可以匹配单个枚举值和switch语句:

 1 directionToHead = .South
 2 switch directionToHead {
 3 case .North:
 4     println("Lots of planets have a north")
 5 case .South:
 6     println("Watch out for penguins")
 7 case .East:
 8     println("Where the sun rises")
 9 case .West:
10     println("Where the skies are blue")
11 }
12 // prints "Watch out for penguins” 

你可以如此理解这段代码:

“考虑directionToHead的值。当它等于.North,打印“Lots of planets have a north”。当它等于.South,打印“Watch out for penguins”。”

等等依次类推。

正如在控制流中介绍,当考虑一个枚举的成员们时,一个switch语句必须全面。如果忽略了.West这种情况,上面那段代码将无法通过编译,因为它没有考虑到CompassPoint的全部成员。全面性的要求确保了枚举成员不会被意外遗漏。

当不需要匹配每个枚举成员的时候,你可以提供一个默认default分支来涵盖所有未明确被提出的任何成员:

1 let somePlanet = Planet.Earth
2 switch somePlanet {
3 case .Earth:
4     println("Mostly harmless")
5 default:
6     println("Not a safe place for humans")
7 }
8 // prints "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 中,用来定义两种商品条码的枚举是这样子的:

1 enum Barcode {
2     case UPCA(Int, Int, Int)
3     case QRCode(String)
4 } 

以上代码可以这么理解:

“定义一个名为Barcode的枚举类型,它可以是UPCA的一个关联值(Int,Int,Int),或者QRCode的一个字符串类型(String)关联值。”

这个定义不提供任何Int或String的实际值,它只是定义了,当Barcode常量和变量等于Barcode.UPCA或Barcode.QRCode时,关联值的类型。

然后可以使用任何一种条码类型创建新的条码,如:

1 var productBarcode = Barcode.UPCA(8, 85909_51226, 3) 

以上例子创建了一个名为productBarcode的新变量,并且赋给它一个Barcode.UPCA的关联元组值(8, 8590951226, 3)。提供的“标识符”值在整数字中有一个下划线,使其便于阅读条形码。

同一个商品可以被分配给一个不同类型的条形码,如:

1 productBarcode = .QRCode("ABCDEFGHIJKLMNOP") 

这时,原始的Barcode.UPCA和其整数值被新的Barcode.QRCode和其字符串值所替代。条形码的常量和变量可以存储一个.UPCA或者一个.QRCode(连同它的关联值),但是在任何指定时间只能存储其中之一。

像以前那样,不同的条形码类型可以使用一个switch语句来检查,然而这次关联值可以被提取作为switch语句的一部分。你可以在switch的case分支代码中提取每个关联值作为一个常量(用let前缀)或者作为一个变量(用var前缀)来使用:

1 switch productBarcode {
2 case .UPCA(let numberSystem, let identifier, let check):
3     println("UPC-A with value of \(numberSystem), \(identifier), \(check).")
4 case .QRCode(let productCode):
5     println("QR code with value of \(productCode).")
6 }
7 // prints "QR code with value of ABCDEFGHIJKLMNOP.” 

如果一个枚举成员的所有关联值被提取为常量,或者它们全部被提取为变量,为了简洁,你可以只放置一个var或者let标注在成员名称前:

1 switch productBarcode {
2 case let .UPCA(numberSystem, identifier, check):
3     println("UPC-A with value of \(numberSystem), \(identifier), \(check).")
4 case let .QRCode(productCode):
5     println("QR code with value of \(productCode).")
6 }
7 // prints "QR code with value of ABCDEFGHIJKLMNOP." 

原始值(Raw Values)

在关联值小节的条形码例子中演示了一个枚举的成员如何声明它们存储不同类型的关联值。作为关联值的替代,枚举成员可以被默认值(称为原始值)预先填充,其中这些原始值具有相同的类型。

这里是一个枚举成员存储原始 ASCII 值的例子:

1 enum ASCIIControlCharacter: Character {
2     case Tab = "\t"
3     case LineFeed = "\n"
4     case CarriageReturn = "\r"
5 } 

在这里,称为ASCIIControlCharacter的枚举的原始值类型被定义为字符型Character,并被设置了一些比较常见的 ASCII 控制字符。字符值的描述请详见字符串和字符章节。

注意,原始值和关联值是不相同的。当你开始在你的代码中定义枚举的时候原始值是被预先填充的值,像上述三个 ASCII 码。对于一个特定的枚举成员,它的原始值始终是相同的。关联值是当你在创建一个基于枚举成员的新常量或变量时才会被设置,并且每次当你这么做得时候,它的值可以是不同的。

原始值可以是字符串,字符,或者任何整型值或浮点型值。每个原始值在它的枚举声明中必须是唯一的。当整型值被用于原始值,如果其他枚举成员没有值时,它们会自动递增。

下面的枚举是对之前Planet这个枚举的一个细化,利用原始整型值来表示每个 planet 在太阳系中的顺序:

1 enum Planet: Int {
2     case Mercury = 1, Venus, Earth, Mars, Jupiter, Saturn, Uranus, Neptune
3 } 

自动递增意味着Planet.Venus的原始值是2,依次类推。

使用枚举成员的toRaw方法可以访问该枚举成员的原始值:

1 let earthsOrder = Planet.Earth.toRaw()
2 // earthsOrder is 3 

使用枚举的fromRaw方法来试图找到具有特定原始值的枚举成员。这个例子通过原始值7识别Uranus:

1 let possiblePlanet = Planet.fromRaw(7)
2 // possiblePlanet is of type Planet? and equals Planet.Uranus 

然而,并非所有可能的Int值都可以找到一个匹配的行星。正因为如此,fromRaw方法可以返回一个可选的枚举成员。在上面的例子中,possiblePlanet是Planet?类型,或“可选的Planet”。

如果你试图寻找一个位置为9的行星,通过fromRaw返回的可选Planet值将是nil:

 1 let positionToFind = 9
 2 if let somePlanet = Planet.fromRaw(positionToFind) {
 3     switch somePlanet {
 4     case .Earth:
 5         println("Mostly harmless")
 6     default:
 7         println("Not a safe place for humans")
 8     }
 9 } else {
10     println("There isn‘t a planet at position \(positionToFind)")
11 }
12 // prints "There isn‘t a planet at position 9

这个范例使用可选绑定(optional binding),通过原始值9试图访问一个行星。if let somePlanet = Planet.fromRaw(9)语句获得一个可选Planet,如果可选Planet可以被获得,把somePlanet设置成该可选Planet的内容。在这个范例中,无法检索到位置为9的行星,所以else分支被执行。

时间: 2024-08-07 08:38:18

The Swift Programming Language-官方教程精译Swift(9) 枚举-- --Enumerations的相关文章

The Swift Programming Language-官方教程精译Swift(6)控制流--Control Flow

Swift提供了类似C语言的流程控制结构,包括可以多次执行任务的for和while循环,基于特定条件选择执行不同代码分支的if和switch语句,还有控制流程跳转到其他代码的break和continue语句. 除了C里面传统的 for 条件递增循环,Swift 还增加了 for-in 循环,用来更简单地遍历数组(array),字典(dictionary),范围(range),字符串(string)和其他序列类型. Swift 的 switch 语句比 C 语言中更加强大.在 C 语言中,如果某个

The Swift Programming Language-官方教程精译Swift(8)闭包 -- Closures

闭包是功能性自包含模块,可以在代码中被传递和使用. Swift 中的闭包与 C 和 Objective-C中的 blocks 以及其他一些编程语言中的 lambdas 比较相似. 闭包可以捕获和存储其所在上下文中任意常量和变量的引用. 这就是所谓的闭合并包裹着这些常量和变量,俗称闭包.Swift会为您管理在捕获过程中涉及到的内存操作.  注意:如果您不熟悉 捕获 (capturing) 这个概念也不用担心,后面会详细对其进行介绍. 在 函数 章节中介绍的全局和嵌套函数实际上也是特殊的闭包,闭包采

The Swift Programming Language-官方教程精译Swift(5)集合类型 -- Collection Types

Swift语言提供经典的数组和字典两种集合类型来存储集合数据.数组用来按顺序存储相同类型的数据.字典虽然无序存储相同类型数据值但是需要由独有的标识符引用和寻址(就是键值对). Swift语言里的数组和字典中存储的数据值类型必须明确. 这意味着我们不能把不正确的数据类型插入其中. 同时这也说明我们完全可以对获取出的值类型非常自信. Swift对显式类型集合的使用确保了我们的代码对工作所需要的类型非常清楚,也让我们在开发中可以早早地找到任何的类型不匹配错误. 注意: Swift的数组结构在被声明成常

The Swift Programming Language-官方教程精译Swift(1)小试牛刀

通常来说,编程语言教程中的第一个程序应该在屏幕上打印“Hello, world”.在 Swift 中,可以用一行代码实现: 1 println("hello, world") 如果你写过 C 或者 Objective-C 代码,那你应该很熟悉这种形式——在 Swift 中,这行代码就是一个完整的程序.你不需要为了输入输出或者字符串处理导入一个单独的库.全局作用域中的代码会被自动当做程序的入口点,所以你也不需要main函数.你同样不需要在每个语句结尾写上分号. 这个教程会通过一系列编程例

The Swift Programming Language-官方教程精译Swift(3)基本运算符

运算符是检查, 改变, 合并值的特殊符号或短语. 例如, 加号 + 把计算两个数的和(如 let i = 1 + 2). 复杂些的运行算包括逻辑与&&(如 if enteredDoorCode && passedRetinaScan), 还有自增运算符 ++i 这样让自身加一的便捷运算. Swift支持大部分标准C语言的运算符, 且改进许多特性来减少常规编码错误. 如, 赋值符 = 不返回值, 以防止错把等号 == 写成赋值号 = 而导致Bug. 数值运算符( + , -,

The Swift Programming Language-官方教程精译Swift(2)基础知识

Swift 的类型是在 C 和 Objective-C 的基础上提出的,Int是整型:Double和Float是浮点型:Bool是布尔型:String是字符串.Swift 还有两个有用的集合类型,Array和Dictionary,请参考集合类型. 就像 C 语言一样,Swift 使用变量来进行存储并通过变量名来关联值.在 Swift 中,值不可变的变量有着广泛的应用,它们就是常量,而且比 C 语言的常量更强大.在 Swift 中,如果你要处理的值不需要改变,那使用常量可以让你的代码更加安全并且更

The Swift Programming Language-官方教程精译Swift(4)字符串和字符

String 是一个有序的字符集合,例如 "hello, world", "albatross".Swift 字符串通过 String 类型来表示,也可以表示为 Character 类型值的集合. Swift 的 String 和 Character 类型提供了一个快速的,兼容 Unicode 的方式来处理代码中的文本信息.创建和操作字符串的语法与 C的操作方式相似,轻量并且易读.字符串连接操作只需要简单地通过 + 号将两个字符串相连即可.与 Swift 中其他值一

[精校版]The Swift Programming Language

通常来说,编程语言教程中的第一个程序应该在屏幕上打印“Hello, world”.在 Swift 中,可以用一行代码实现: println("hello, world") 如果你写过 C 或者 Objective-C 代码,那你应该很熟悉这种形式——在 Swift 中,这行代码就是一个完整的程序.你不需要为了输入输出或者字符串处理导入一个单独的库.全局作用域中的代码会被自动当做程序的入口点,所以你也不需要main函数.你同样不需要在每个语句结尾写上分号. 这个教程会通过一系列编程例子来

一群牛人翻译:The Swift Programming Language 中文版

无聊闲逛GIthub,看到一群牛人在github上创建了一个关于Switf的文档翻译项目 The Swift Programming Language 中文版 项目地址:中文版 Apple 官方 Swift 教程<The Swift Programming Language> 需要的小伙伴们速度去查阅. 到现在6月12日下午4:59.英文版的手册仅发布9天. star和fork的数量增长惊人 一群牛人翻译:The Swift Programming Language 中文版