在 9.4. 关联值 小节的条形码例子中,演示了如何声明存储不同类型关联值的枚举成员。作为关联值的替代选择,枚举成员可以被默认值(称为原始值)预填充,这些原始值的类型必须相同。
这是一个使用 ASCII 码作为原始值的枚举:
enum ASCIIControlCharacter: Character {
case tab = "\t"
case lineFeed = "\n"
case carriageReturn = "\r"
}
枚举类型 ASCIIControlCharacter
的原始值类型被定义为 Character
,并设置了一些比较常见的 ASCII 控制字符。Character
的描述详见 第四章:字符串和字符 部分。
原始值可以是字符串、字符,或者任意整型值或浮点型值。每个原始值在枚举声明中必须是唯一的。
注意
原始值和关联值是不同的。原始值是在定义枚举时被预先填充的值,像上述三个 ASCII 码。对于一个特定的枚举成员,它的原始值始终不变。关联值是创建一个基于枚举成员的常量或变量时才设置的值,枚举成员的关联值可以变化。
原始值的隐式赋值
在使用原始值为整数或者字符串类型的枚举时,不需要显式地为每一个枚举成员设置原始值,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
分支被执行。