枚举成员可以被默认值(称为原始值)预填充,这些原始值的类型必须相同。
这是一个使用 ASCII 码作为原始值的枚举:
enum ASCIIControlCharacter: Character { case tab = "\t" case lineFeed = "\n" case carriageReturn = "\r" }
枚举类型 ASCIIControlCharacter
的原始值类型被定义为 Character
,并设置了一些比较常见的 ASCII 控制字符。Character
的描述详见 字符串和字符 部分。
原始值可以是字符串、字符,或者任意整型值或浮点型值。每个原始值在枚举声明中必须是唯一的。
原始值的隐式赋值
在使用原始值为整数或者字符串类型的枚举时,不需要显式地为每一个枚举成员设置原始值,Swift 将会自动为你赋值。
例如,当使用整数作为原始值时,隐式赋值的值依次递增 1
。如果第一个枚举成员没有设置原始值,其原始值将为 0
。
下面的枚举是对之前 Planet
这个枚举的一个细化,利用整型的原始值来表示每个行星在太阳系中的顺序:
enum Planet: Int { case mercury = 1, venus, earth, mars, jupiter, saturn, uranus, neptune }
在上面的例子中,Plant.mercury
的显式原始值为 1
,Planet.venus
的隐式原始值为 2
,依次类推。
当使用字符串作为枚举类型的原始值时,每个枚举成员的隐式原始值为该枚举成员的名称。
下面的例子是 CompassPoint
枚举的细化,使用字符串类型的原始值来表示各个方向的名称:
enum CompassPoint: String { case north, south, east, west }
上面例子中,CompassPoint.south
拥有隐式原始值 south
,依次类推。
使用枚举成员的 rawValue
属性可以访问该枚举成员的原始值:
let earthsOrder = Planet.earth.rawValue // earthsOrder 值为 3 let sunsetDirection = CompassPoint.west.rawValue // sunsetDirection 值为 "west"
使用原始值初始化枚举实例
如果在定义枚举类型的时候使用了原始值,那么将会自动获得一个初始化方法,这个方法接收一个叫做 rawValue
的参数,参数类型即为原始值类型,返回值则是枚举成员或 nil
。你可以使用这个初始化方法来创建一个新的枚举实例。
这个例子利用原始值 7
创建了枚举成员 Uranus
:
let possiblePlanet = Planet(rawValue: 7) // possiblePlanet 类型为 Planet? 值为 Planet.uranus
然而,并非所有 Int
值都可以找到一个匹配的行星。因此,原始值构造器总是返回一个可选的枚举成员。在上面的例子中,possiblePlanet
是 Planet?
类型,或者说“可选的 Planet
”。
注意
原始值构造器是一个可失败构造器,因为并不是每一个原始值都有与之对应的枚举成员。更多信息请参见 可失败构造器。
如果你试图寻找一个位置为 11
的行星,通过原始值构造器返回的可选 Planet
值将是 nil
:
let positionToFind = 11 if let somePlanet = Planet(rawValue: positionToFind) { switch somePlanet { case .earth: print("Mostly harmless") default: print("Not a safe place for humans") } } else { print("There isn't a planet at position \(positionToFind)") } // 打印“There isn't a planet at position 11”
这个例子使用了可选绑定(optional binding),试图通过原始值 11
来访问一个行星。if let somePlanet = Planet(rawValue: 11)
语句创建了一个可选 Planet
,如果可选 Planet
的值存在,就会赋值给 somePlanet
。在这个例子中,无法检索到位置为 11
的行星,所以 else
分支被执行。