1.0 翻译:Jasonbroker 校对:numbbbbb, stanzhai
2.0 翻译+校对:lyojo
2.1 校对:shanks,2015-10-31
2.2 翻译+校对:SketchK 2016-05-15
3.0.1,shanks,2016-11-13
本页包含内容:
可选链式调用是一种可以在当前值可能为nil
的可选值上请求和调用属性、方法及下标的方法。如果可选值有值,那么调用就会成功;如果可选值是nil
,那么调用将返回nil
。多个调用可以连接在一起形成一个调用链,如果其中任何一个节点为nil
,整个调用链都会失败,即返回nil
。
注意
Swift 的可选链式调用和 Objective-C 中向nil
发送消息有些相像,但是 Swift 的可选链式调用可以应用于任意类型,并且能检查调用是否成功。
通过在想调用的属性、方法、或下标的可选值后面放一个问号(?
),可以定义一个可选链。这一点很像在可选值后面放一个叹号(!
)来强制展开它的值。它们的主要区别在于当可选值为空时可选链式调用只会调用失败,然而强制展开将会触发运行时错误。
为了反映可选链式调用可以在空值(nil
)上调用的事实,不论这个调用的属性、方法及下标返回的值是不是可选值,它的返回结果都是一个可选值。你可以利用这个返回值来判断你的可选链式调用是否调用成功,如果调用有返回值则说明调用成功,返回nil
则说明调用失败。
特别地,可选链式调用的返回结果与原本的返回结果具有相同的类型,但是被包装成了一个可选值。例如,使用可选链式调用访问属性,当可选链式调用成功时,如果属性原本的返回结果是Int
类型,则会变为Int?
类型。
下面几段代码将解释可选链式调用和强制展开的不同。
首先定义两个类Person
和Residence
:
class Person {
var residence: Residence?
}
class Residence {
var numberOfRooms = 1
}
Residence
有一个Int
类型的属性numberOfRooms
,其默认值为1
。Person
具有一个可选的residence
属性,其类型为Residence?
。
假如你创建了一个新的Person
实例,它的residence
属性由于是是可选型而将初始化为nil
,在下面的代码中,john
有一个值为nil
的residence
属性:
let john = Person()
如果使用叹号(!
)强制展开获得这个john
的residence
属性中的numberOfRooms
值,会触发运行时错误,因为这时residence
没有可以展开的值:
let roomCount = john.residence!.numberOfRooms
// 这会引发运行时错误
john.residence
为非nil
值的时候,上面的调用会成功,并且把roomCount
设置为Int
类型的房间数量。正如上面提到的,当residence
为nil
的时候上面这段代码会触发运行时错误。
可选链式调用提供了另一种访问numberOfRooms
的方式,使用问号(?
)来替代原来的叹号(!
):
if let roomCount = john.residence?.numberOfRooms {
print("John's residence has \(roomCount) room(s).")
} else {
print("Unable to retrieve the number of rooms.")
}
// 打印 “Unable to retrieve the number of rooms.”
在residence
后面添加问号之后,Swift 就会在residence
不为nil
的情况下访问numberOfRooms
。
因为访问numberOfRooms
有可能失败,可选链式调用会返回Int?
类型,或称为“可选的 Int
”。如上例所示,当residence
为nil
的时候,可选的Int
将会为nil
,表明无法访问numberOfRooms
。访问成功时,可选的Int
值会通过可选绑定展开,并赋值给非可选类型的roomCount
常量。
要注意的是,即使numberOfRooms
是非可选的Int
时,这一点也成立。只要使用可选链式调用就意味着numberOfRooms
会返回一个Int?
而不是Int
。
可以将一个Residence
的实例赋给john.residence
,这样它就不再是nil
了:
john.residence = Residence()
john.residence
现在包含一个实际的Residence
实例,而不再是nil
。如果你试图使用先前的可选链式调用访问numberOfRooms
,它现在将返回值为1
的Int?
类型的值:
if let roomCount = john.residence?.numberOfRooms {
print("John's residence has \(roomCount) room(s).")
} else {
print("Unable to retrieve the number of rooms.")
}
// 打印 “John's residence has 1 room(s).”
通过使用可选链式调用可以调用多层属性、方法和下标。这样可以在复杂的模型中向下访问各种子属性,并且判断能否访问子属性的属性、方法或下标。
下面这段代码定义了四个模型类,这些例子包括多层可选链式调用。为了方便说明,在Person
和Residence
的基础上增加了Room
类和Address
类,以及相关的属性、方法以及下标。
Person
类的定义基本保持不变:
class Person {
var residence: Residence?
}
Residence
类比之前复杂些,增加了一个名为rooms
的变量属性,该属性被初始化为[Room]
类型的空数组:
class Residence {
var rooms = [Room]()
var numberOfRooms: Int {
return rooms.count
}
subscript(i: Int) -> Room {
get {
return rooms[i]
}
set {
rooms[i] = newValue
}
}
func printNumberOfRooms() {
print("The number of rooms is \(numberOfRooms)")
}
var address: Address?
}
现在Residence
有了一个存储Room
实例的数组,numberOfRooms
属性被实现为计算型属性,而不是存储型属性。numberOfRooms
属性简单地返回rooms
数组的count
属性的值。
Residence
还提供了访问rooms
数组的快捷方式,即提供可读写的下标来访问rooms
数组中指定位置的元素。
此外,Residence
还提供了printNumberOfRooms
方法,这个方法的作用是打印numberOfRooms
的值。
最后,Residence
还定义了一个可选属性address
,其类型为Address?
。Address
类的定义在下面会说明。
Room
类是一个简单类,其实例被存储在rooms
数组中。该类只包含一个属性name
,以及一个用于将该属性设置为适当的房间名的初始化函数:
class Room {
let name: String
init(name: String) { self.name = name }
}
最后一个类是Address
,这个类有三个String?
类型的可选属性。buildingName
以及buildingNumber
属性分别表示某个大厦的名称和号码,第三个属性street
表示大厦所在街道的名称:
class Address {
var buildingName: String?
var buildingNumber: String?
var street: String?
func buildingIdentifier() -> String? {
if buildingName != nil {
return buildingName
} else if buildingNumber != nil && street != nil {
return "\(buildingNumber) \(street)"
} else {
return nil
}
}
}
Address
类提供了buildingIdentifier()
方法,返回值为String?
。 如果buildingName
有值则返回buildingName
。或者,如果buildingNumber
和street
均有值则返回buildingNumber
。否则,返回nil
。
正如使用可选链式调用代替强制展开中所述,可以通过可选链式调用在一个可选值上访问它的属性,并判断访问是否成功。
下面的代码创建了一个Person
实例,然后像之前一样,尝试访问numberOfRooms
属性:
let john = Person()
if let roomCount = john.residence?.numberOfRooms {
print("John's residence has \(roomCount) room(s).")
} else {
print("Unable to retrieve the number of rooms.")
}
// 打印 “Unable to retrieve the number of rooms.”
因为john.residence
为nil
,所以这个可选链式调用依旧会像先前一样失败。
还可以通过可选链式调用来设置属性值:
let someAddress = Address()
someAddress.buildingNumber = "29"
someAddress.street = "Acacia Road"
john.residence?.address = someAddress
在这个例子中,通过john.residence
来设定address
属性也会失败,因为john.residence
当前为nil
。
上面代码中的赋值过程是可选链式调用的一部分,这意味着可选链式调用失败时,等号右侧的代码不会被执行。对于上面的代码来说,很难验证这一点,因为像这样赋值一个常量没有任何副作用。下面的代码完成了同样的事情,但是它使用一个函数来创建Address
实例,然后将该实例返回用于赋值。该函数会在返回前打印“Function was called”,这使你能验证等号右侧的代码是否被执行。
func createAddress() -> Address {
print("Function was called.")
let someAddress = Address()
someAddress.buildingNumber = "29"
someAddress.street = "Acacia Road"
return someAddress
}
john.residence?.address = createAddress()
没有任何打印消息,可以看出createAddress()
函数并未被执行。
可以通过可选链式调用来调用方法,并判断是否调用成功,即使这个方法没有返回值。
Residence
类中的printNumberOfRooms()
方法打印当前的numberOfRooms
值,如下所示:
func printNumberOfRooms() {
print("The number of rooms is \(numberOfRooms)")
}
这个方法没有返回值。然而,没有返回值的方法具有隐式的返回类型Void
,如无返回值函数中所述。这意味着没有返回值的方法也会返回()
,或者说空的元组。
如果在可选值上通过可选链式调用来调用这个方法,该方法的返回类型会是Void?
,而不是Void
,因为通过可选链式调用得到的返回值都是可选的。这样我们就可以使用if
语句来判断能否成功调用printNumberOfRooms()
方法,即使方法本身没有定义返回值。通过判断返回值是否为nil
可以判断调用是否成功:
if john.residence?.printNumberOfRooms() != nil {
print("It was possible to print the number of rooms.")
} else {
print("It was not possible to print the number of rooms.")
}
// 打印 “It was not possible to print the number of rooms.”
同样的,可以据此判断通过可选链式调用为属性赋值是否成功。在上面的通过可选链式调用访问属性的例子中,我们尝试给john.residence
中的address
属性赋值,即使residence
为nil
。通过可选链式调用给属性赋值会返回Void?
,通过判断返回值是否为nil
就可以知道赋值是否成功:
if (john.residence?.address = someAddress) != nil {
print("It was possible to set the address.")
} else {
print("It was not possible to set the address.")
}
// 打印 “It was not possible to set the address.”
通过可选链式调用,我们可以在一个可选值上访问下标,并且判断下标调用是否成功。
注意
通过可选链式调用访问可选值的下标时,应该将问号放在下标方括号的前面而不是后面。可选链式调用的问号一般直接跟在可选表达式的后面。
下面这个例子用下标访问john.residence
属性存储的Residence
实例的rooms
数组中的第一个房间的名称,因为john.residence
为nil
,所以下标调用失败了:
if let firstRoomName = john.residence?[0].name {
print("The first room name is \(firstRoomName).")
} else {
print("Unable to retrieve the first room name.")
}
// 打印 “Unable to retrieve the first room name.”
在这个例子中,问号直接放在john.residence
的后面,并且在方括号的前面,因为john.residence
是可选值。
类似的,可以通过下标,用可选链式调用来赋值:
john.residence?[0] = Room(name: "Bathroom")
这次赋值同样会失败,因为residence
目前是nil
。
如果你创建一个Residence
实例,并为其rooms
数组添加一些Room
实例,然后将Residence
实例赋值给john.residence
,那就可以通过可选链和下标来访问数组中的元素:
let johnsHouse = Residence()
johnsHouse.rooms.append(Room(name: "Living Room"))
johnsHouse.rooms.append(Room(name: "Kitchen"))
john.residence = johnsHouse
if let firstRoomName = john.residence?[0].name {
print("The first room name is \(firstRoomName).")
} else {
print("Unable to retrieve the first room name.")
}
// 打印 “The first room name is Living Room.”
如果下标返回可选类型值,比如 Swift 中Dictionary
类型的键的下标,可以在下标的结尾括号后面放一个问号来在其可选返回值上进行可选链式调用:
var testScores = ["Dave": [86, 82, 84], "Bev": [79, 94, 81]]
testScores["Dave"]?[0] = 91
testScores["Bev"]?[0] += 1
testScores["Brian"]?[0] = 72
// "Dave" 数组现在是 [91, 82, 84],"Bev" 数组现在是 [80, 94, 81]
上面的例子中定义了一个testScores
数组,包含了两个键值对,把String
类型的键映射到一个Int
值的数组。这个例子用可选链式调用把"Dave"
数组中第一个元素设为91
,把"Bev"
数组的第一个元素+1
,然后尝试把"Brian"
数组中的第一个元素设为72
。前两个调用成功,因为testScores
字典中包含"Dave"
和"Bev"
这两个键。但是testScores
字典中没有"Brian"
这个键,所以第三个调用失败。
可以通过连接多个可选链式调用在更深的模型层级中访问属性、方法以及下标。然而,多层可选链式调用不会增加返回值的可选层级。
也就是说:
因此:
Int
值,将会返回Int?
,无论使用了多少层可选链式调用。Int?
值,依旧会返回Int?
值,并不会返回Int??
。下面的例子尝试访问john
中的residence
属性中的address
属性中的street
属性。这里使用了两层可选链式调用,residence
以及address
都是可选值:
if let johnsStreet = john.residence?.address?.street {
print("John's street name is \(johnsStreet).")
} else {
print("Unable to retrieve the address.")
}
// 打印 “Unable to retrieve the address.”
john.residence
现在包含一个有效的Residence
实例。然而,john.residence.address
的值当前为nil
。因此,调用john.residence?.address?.street
会失败。
需要注意的是,上面的例子中,street
的属性为String?
。john.residence?.address?.street
的返回值也依然是String?
,即使已经使用了两层可选链式调用。
如果为john.residence.address
赋值一个Address
实例,并且为address
中的street
属性设置一个有效值,我们就能过通过可选链式调用来访问street
属性:
let johnsAddress = Address()
johnsAddress.buildingName = "The Larches"
johnsAddress.street = "Laurel Street"
john.residence?.address = johnsAddress
if let johnsStreet = john.residence?.address?.street {
print("John's street name is \(johnsStreet).")
} else {
print("Unable to retrieve the address.")
}
// 打印 “John's street name is Laurel Street.”
在上面的例子中,因为john.residence
包含一个有效的Residence
实例,所以对john.residence
的address
属性赋值将会成功。
上面的例子展示了如何在一个可选值上通过可选链式调用来获取它的属性值。我们还可以在一个可选值上通过可选链式调用来调用方法,并且可以根据需要继续在方法的可选返回值上进行可选链式调用。
在下面的例子中,通过可选链式调用来调用Address
的buildingIdentifier()
方法。这个方法返回String?
类型的值。如上所述,通过可选链式调用来调用该方法,最终的返回值依旧会是String?
类型:
if let buildingIdentifier = john.residence?.address?.buildingIdentifier() {
print("John's building identifier is \(buildingIdentifier).")
}
// 打印 “John's building identifier is The Larches.”
如果要在该方法的返回值上进行可选链式调用,在方法的圆括号后面加上问号即可:
if let beginsWithThe =
john.residence?.address?.buildingIdentifier()?.hasPrefix("The") {
if beginsWithThe {
print("John's building identifier begins with \"The\".")
} else {
print("John's building identifier does not begin with \"The\".")
}
}
// 打印 “John's building identifier begins with "The".”
注意
在上面的例子中,在方法的圆括号后面加上问号是因为你要在buildingIdentifier()
方法的可选返回值上进行可选链式调用,而不是方法本身。