make gitbook

This commit is contained in:
numbbbbb
2014-06-14 23:24:20 +08:00
parent a0489eef96
commit 4634005f9c
42 changed files with 981 additions and 1046 deletions

View File

@ -46,7 +46,7 @@
<div class="book" data-level="2.17" data-basepath=".." data-revision="1402750255397">
<div class="book" data-level="2.17" data-basepath=".." data-revision="1402759431779">
<div class="book-header">
<!-- Actions Left -->
<a href="#" class="btn pull-left toggle-summary" aria-label="Toggle summary"><i class="fa fa-align-justify"></i></a>
@ -587,11 +587,10 @@
<div class="page-inner">
<section class="normal" id="section-gitbook_66">
<section class="normal" id="section-gitbook_542">
<blockquote>
<p>翻译Jasonbroker</p>
<p>校对numbbbbb</p>
<p>翻译Jasonbroker<br>校对numbbbbb, stanzhai </p>
</blockquote>
<h1 id="optional-chaining">Optional Chaining</h1>
<hr>
@ -607,8 +606,7 @@
</ul>
<p>可选链Optional Chaining是一种可以请求和调用属性、方法及子脚本的过程它的可选性体现于请求或调用的目标当前可能为空<code>nil</code>)。如果可选的目标有值,那么调用就会成功;相反,如果选择的目标为空(<code>nil</code>),则这种调用将返回空(<code>nil</code>)。多次请求或调用可以被链接在一起形成一个链,如果任何一个节点为空(<code>nil</code>)将导致整个链失效。</p>
<blockquote>
<p>注意:
Swift 的可选链和 Objective-C 中的消息为空有些相像,但是 Swift 可以使用在任意类型中,并且失败与否可以被检测到。</p>
<p>注意:<br>Swift 的可选链和 Objective-C 中的消息为空有些相像,但是 Swift 可以使用在任意类型中,并且失败与否可以被检测到。</p>
</blockquote>
<p><a name="optional_chaining_as_an_alternative_to_forced_unwrapping"></a></p>
<h2 id="-">可选链可替代强制解析</h2>
@ -617,49 +615,56 @@ Swift 的可选链和 Objective-C 中的消息为空有些相像,但是 Swift
<p>调用可选链的返回结果与原本的返回结果具有相同的类型,但是原本的返回结果被包装成了一个可选值,当可选链调用成功时,一个应该返回<code>Int</code>的属性将会返回<code>Int?</code></p>
<p>下面几段代码将解释可选链和强制解析的不同。</p>
<p>首先定义两个类<code>Person</code><code>Residence</code></p>
<pre><code>class Person {
<pre><code class="lang-swift">class Person {
var residence: Residence?
}
class Residence {
var numberOfRooms = 1
}
</code></pre><p><code>Residence</code>具有一个<code>Int</code>类型的<code>numberOfRooms</code>,其值为 1。<code>Person</code>具有一个可选<code>residence</code>属性,它的类型是<code>Residence</code></p>
</code></pre>
<p><code>Residence</code>具有一个<code>Int</code>类型的<code>numberOfRooms</code>,其值为 1。<code>Person</code>具有一个可选<code>residence</code>属性,它的类型是<code>Residence</code></p>
<p>如果你创建一个新的<code>Person</code>实例,它的<code>residence</code>属性由于是被定义为可选型的,此属性将默认初始化为空:</p>
<pre><code>let john = Person()
</code></pre><p>如果你想使用感叹号(<code>!</code>)强制解析获得这个人<code>residence</code>属性<code>numberOfRooms</code>属性值,将会引发运行时错误,因为这时没有可以供解析的<code>residence</code>值。</p>
<pre><code>let roomCount = john.residence!.numberOfRooms
<pre><code class="lang-swift">let john = Person()
</code></pre>
<p>如果你想使用感叹号(<code>!</code>)强制解析获得这个人<code>residence</code>属性<code>numberOfRooms</code>属性值,将会引发运行时错误,因为这时没有可以供解析的<code>residence</code>值。</p>
<pre><code class="lang-swift">let roomCount = john.residence!.numberOfRooms
//将导致运行时错误
</code></pre><p><code>john.residence</code>不是<code>nil</code>时,会运行通过,且会将<code>roomCount</code> 设置为一个<code>int</code>类型的合理值。然而,如上所述,当<code>residence</code>为空时,这个代码将会导致运行时错误。</p>
</code></pre>
<p><code>john.residence</code>不是<code>nil</code>时,会运行通过,且会将<code>roomCount</code> 设置为一个<code>int</code>类型的合理值。然而,如上所述,当<code>residence</code>为空时,这个代码将会导致运行时错误。</p>
<p>可选链提供了一种另一种获得<code>numberOfRooms</code>的方法。利用可选链,使用问号来代替原来<code>!</code>的位置:</p>
<pre><code>if let roomCount = john.residence?.numberOfRooms {
<pre><code class="lang-swift">if let roomCount = john.residence?.numberOfRooms {
println(&quot;John&#39;s residence has \(roomCount) room(s).&quot;)
} else {
println(&quot;Unable to retrieve the number of rooms.&quot;)
}
// 打印 &quot;Unable to retrieve the number of rooms.
</code></pre><p>这告诉 Swift 来链接可选<code>residence?</code>属性,如果<code>residence</code>存在则取回<code>numberOfRooms</code>的值。</p>
</code></pre>
<p>这告诉 Swift 来链接可选<code>residence?</code>属性,如果<code>residence</code>存在则取回<code>numberOfRooms</code>的值。</p>
<p>因为这种尝试获得<code>numberOfRooms</code>的操作有可能失败,可选链会返回<code>Int?</code>类型值,或者称作“可选<code>Int</code>”。当<code>residence</code>是空的时候(上例),选择<code>Int</code>将会为空,因此会出先无法访问<code>numberOfRooms</code>的情况。</p>
<p>要注意的是即使numberOfRooms是非可选<code>Int</code><code>Int?</code>)时这一点也成立。只要是通过可选链的请求就意味着最后<code>numberOfRooms</code>总是返回一个<code>Int?</code>而不是<code>Int</code></p>
<p>你可以自己定义一个<code>Residence</code>实例给<code>john.residence</code>,这样它就不再为空了:</p>
<pre><code>john.residence = Residence()
</code></pre><p><code>john.residence</code> 现在有了实际存在的实例而不是nil了。如果你想使用和前面一样的可选链来获得<code>numberOfRoooms</code>,它将返回一个包含默认值 1 的<code>Int?</code></p>
<pre><code>if let roomCount = john.residence?.numberOfRooms {
<pre><code class="lang-swift">john.residence = Residence()
</code></pre>
<p><code>john.residence</code> 现在有了实际存在的实例而不是nil了。如果你想使用和前面一样的可选链来获得<code>numberOfRoooms</code>,它将返回一个包含默认值 1 的<code>Int?</code></p>
<pre><code class="lang-swift">if let roomCount = john.residence?.numberOfRooms {
println(&quot;John&#39;s residence has \(roomCount) room(s).&quot;)
} else {
println(&quot;Unable to retrieve the number of rooms.&quot;)
}
// 打印 &quot;John&#39;s residence has 1 room(s)&quot;
</code></pre><p><a name="defining_model_classes_for_optional_chaining"></a></p>
</code></pre>
<p><a name="defining_model_classes_for_optional_chaining"></a></p>
<h2 id="-">为可选链定义模型类</h2>
<p>你可以使用可选链来多层调用属性,方法,和子脚本。这让你可以利用它们之间的复杂模型来获取更底层的属性,并检查是否可以成功获取此类底层属性。</p>
<p>后面的代码定义了四个将在后面使用的模型类,其中包括多层可选链。这些类是由上面的<code>Person</code><code>Residence</code>模型通过添加一个<code>Room</code>和一个<code>Address</code>类拓展来。</p>
<p><code>Person</code>类定义与之前相同。</p>
<pre><code>class Person {
<pre><code class="lang-swift">class Person {
var residence: Residence?
}
</code></pre><p><code>Residence</code>类比之前复杂些。这次,它定义了一个变量 <code>rooms</code>,它被初始化为一个<code>Room[]</code>类型的空数组:</p>
<pre><code>class Residence {
</code></pre>
<p><code>Residence</code>类比之前复杂些。这次,它定义了一个变量 <code>rooms</code>,它被初始化为一个<code>Room[]</code>类型的空数组:</p>
<pre><code class="lang-swift">class Residence {
var rooms = Room[]()
var numberOfRooms: Int {
return rooms.count
@ -672,17 +677,19 @@ class Residence {
}
var address: Address?
}
</code></pre><p>因为<code>Residence</code>存储了一个<code>Room</code>实例的数组,它的<code>numberOfRooms</code>属性值不是一个固定的存储值,而是通过计算而来的。<code>numberOfRooms</code>属性值是由返回<code>rooms</code>数组的<code>count</code>属性值得到的。</p>
</code></pre>
<p>因为<code>Residence</code>存储了一个<code>Room</code>实例的数组,它的<code>numberOfRooms</code>属性值不是一个固定的存储值,而是通过计算而来的。<code>numberOfRooms</code>属性值是由返回<code>rooms</code>数组的<code>count</code>属性值得到的。</p>
<p>为了能快速访问<code>rooms</code>数组,<code>Residence</code>定义了一个只读的子脚本,通过插入数组的元素角标就可以成功调用。如果该角标存在,子脚本则将该元素返回。</p>
<p><code>Residence</code>中也提供了一个<code>printNumberOfRooms</code>的方法,即简单的打印房间个数。</p>
<p>最后,<code>Residence</code>定义了一个可选属性叫<code>address</code><code>address?</code>)。<code>Address</code>类的属性将在后面定义。
用于<code>rooms</code>数组的<code>Room</code>类是一个很简单的类,它只有一个<code>name</code>属性和一个设定<code>room</code>名的初始化器。</p>
<pre><code>class Room {
<pre><code class="lang-swift">class Room {
let name: String
init(name: String) { self.name = name }
}
</code></pre><p>这个模型中的最终类叫做<code>Address</code>。它有三个类型是<code>String?</code>的可选属性。前面两个可选属性<code>buildingName</code><code>buildingNumber</code>作为地址的一部分,是定义某个建筑物的两种方式。第三个属性<code>street</code>,用于命名地址的街道名:</p>
<pre><code>class Address {
</code></pre>
<p>这个模型中的最终类叫做<code>Address</code>。它有三个类型是<code>String?</code>的可选属性。前面两个可选属性<code>buildingName</code><code>buildingNumber</code>作为地址的一部分,是定义某个建筑物的两种方式。第三个属性<code>street</code>,用于命名地址的街道名:</p>
<pre><code class="lang-swift">class Address {
var buildingName: String?
var buildingNumber: String?
var street: String?
@ -696,51 +703,55 @@ class Residence {
}
}
}
</code></pre><p><code>Address</code>类还提供了一个<code>buildingIdentifier</code>的方法,它的返回值类型为<code>String?</code>。这个方法检查<code>buildingName</code><code>buildingNumber</code>的属性,如果<code>buildingName</code>有值则将其返回,或者如果<code>buildingNumber</code>有值则将其返回,再或如果没有一个属性有值,返回空。</p>
</code></pre>
<p><code>Address</code>类还提供了一个<code>buildingIdentifier</code>的方法,它的返回值类型为<code>String?</code>。这个方法检查<code>buildingName</code><code>buildingNumber</code>的属性,如果<code>buildingName</code>有值则将其返回,或者如果<code>buildingNumber</code>有值则将其返回,再或如果没有一个属性有值,返回空。</p>
<p><a name="calling_properties_through_optional_chaining"></a></p>
<h2 id="-">通过可选链调用属性</h2>
<p>正如上面“ <a href="#optional_chaining_as_an_alternative_to_forced_unwrapping">可选链可替代强制解析</a>”中所述,你可以利用可选链的可选值获取属性,并且检查属性是否获取成功。然而,你不能使用可选链为属性赋值。</p>
<p>使用上述定义的类来创建一个人实例,并再次尝试后去它的<code>numberOfRooms</code>属性:</p>
<pre><code>let john = Person()
<pre><code class="lang-swift">let john = Person()
if let roomCount = john.residence?.numberOfRooms {
println(&quot;John&#39;s residence has \(roomCount) room(s).&quot;)
} else {
println(&quot;Unable to retrieve the number of rooms.&quot;)
}
// 打印 &quot;Unable to retrieve the number of rooms。
</code></pre><p>由于<code>john.residence</code>是空,所以这个可选链和之前一样失败了,但是没有运行时错误。</p>
</code></pre>
<p>由于<code>john.residence</code>是空,所以这个可选链和之前一样失败了,但是没有运行时错误。</p>
<p><a name="calling_methods_through_optional_chaining"></a></p>
<h2 id="-">通过可选链调用方法</h2>
<p>你可以使用可选链的来调用可选值的方法并检查方法调用是否成功。即使这个方法没有返回值,你依然可以使用可选链来达成这一目的。</p>
<p><code>Residence</code><code>printNumberOfRooms</code>方法会打印<code>numberOfRooms</code>的当前值。方法如下:</p>
<pre><code>func printNumberOfRooms(){
<pre><code class="lang-swift">func printNumberOfRooms(){
println(“The number of rooms is \(numberOfRooms)”)
}
</code></pre><p>这个方法没有返回值。但是,没有返回值类型的函数和方法有一个隐式的返回值类型<code>Void</code>参见Function Without Return Values</p>
</code></pre>
<p>这个方法没有返回值。但是,没有返回值类型的函数和方法有一个隐式的返回值类型<code>Void</code>参见Function Without Return Values</p>
<p>如果你利用可选链调用此方法,这个方法的返回值类型将是<code>Void?</code>,而不是<code>Void</code>因为当通过可选链调用方法时返回值总是可选类型optional type。即使这个方法本身没有定义返回值你也可以使用<code>if</code>语句来检查是否能成功调用<code>printNumberOfRooms</code>方法:如果方法通过可选链调用成功,<code>printNumberOfRooms</code>的隐式返回值将会是<code>Void</code>,如果没有成功,将返回<code>nil</code></p>
<pre><code>if john.residence?.printNumberOfRooms() {
<pre><code class="lang-swift">if john.residence?.printNumberOfRooms() {
println(&quot;It was possible to print the number of rooms.&quot;)
} else {
println(&quot;It was not possible to print the number of rooms.&quot;)
}
// 打印 &quot;It was not possible to print the number of rooms.&quot;
</code></pre><p><a name="calling_subscripts_through_optional_chaining"></a></p>
</code></pre>
<p><a name="calling_subscripts_through_optional_chaining"></a></p>
<h2 id="-">使用可选链调用子脚本</h2>
<p>你可以使用可选链来尝试从子脚本获取值并检查子脚本的调用是否成功,然而,你不能通过可选链来设置子代码。</p>
<blockquote>
<p>注意:
当你使用可选链来获取子脚本的时候,你应该将问号放在子脚本括号的前面而不是后面。可选链的问号一般直接跟在表达语句的后面。</p>
<p>注意:<br>当你使用可选链来获取子脚本的时候,你应该将问号放在子脚本括号的前面而不是后面。可选链的问号一般直接跟在表达语句的后面。</p>
</blockquote>
<p>下面这个例子用在<code>Residence</code>类中定义的子脚本来获取<code>john.residence</code>数组中第一个房间的名字。因为<code>john.residence</code>现在是<code>nil</code>,子脚本的调用失败了。</p>
<pre><code>if let firstRoomName = john.residence?[0].name {
<pre><code class="lang-swift">if let firstRoomName = john.residence?[0].name {
println(&quot;The first room name is \(firstRoomName).&quot;)
} else {
println(&quot;Unable to retrieve the first room name.&quot;)
}
// 打印 &quot;Unable to retrieve the first room name.&quot;
</code></pre><p>在子代码调用中可选链的问号直接跟在<code>john.residence</code>的后面,在子脚本括号的前面,因为<code>john.residence</code>是可选链试图获得的可选值。</p>
</code></pre>
<p>在子代码调用中可选链的问号直接跟在<code>john.residence</code>的后面,在子脚本括号的前面,因为<code>john.residence</code>是可选链试图获得的可选值。</p>
<p>如果你创建一个<code>Residence</code>实例给<code>john.residence</code>,且在他的<code>rooms</code>数组中有一个或多个<code>Room</code>实例,那么你可以使用可选链通过<code>Residence</code>子脚本来获取在<code>rooms</code>数组中的实例了:</p>
<pre><code>let johnsHouse = Residence()
<pre><code class="lang-swift">let johnsHouse = Residence()
johnsHouse.rooms += Room(name: &quot;Living Room&quot;)
johnsHouse.rooms += Room(name: &quot;Kitchen&quot;)
john.residence = johnsHouse
@ -751,7 +762,8 @@ if let firstRoomName = john.residence?[0].name {
println(&quot;Unable to retrieve the first room name.&quot;)
}
// 打印 &quot;The first room name is Living Room.&quot;
</code></pre><p><a name="linking_multiple_levels_of_chaining"></a></p>
</code></pre>
<p><a name="linking_multiple_levels_of_chaining"></a></p>
<h2 id="-">连接多层链接</h2>
<p>你可以将多层可选链连接在一起,可以掘取模型内更下层的属性方法和子脚本。然而多层可选链不能再添加比已经返回的可选值更多的层。
也就是说:</p>
@ -761,43 +773,46 @@ if let firstRoomName = john.residence?[0].name {
<p>如果你试图通过可选链获得<code>Int</code>值,不论使用了多少层链接返回的总是<code>Int?</code>
相似的,如果你试图通过可选链获得<code>Int?</code>值,不论使用了多少层链接返回的总是<code>Int?</code></p>
<p>下面的例子试图获取<code>john</code><code>residence</code>属性里的<code>address</code><code>street</code>属性。这里使用了两层可选链来联系<code>residence</code><code>address</code>属性,它们两者都是可选类型:</p>
<pre><code>if let johnsStreet = john.residence?.address?.street {
<pre><code class="lang-swift">if let johnsStreet = john.residence?.address?.street {
println(&quot;John&#39;s street name is \(johnsStreet).&quot;)
} else {
println(&quot;Unable to retrieve the address.&quot;)
}
// 打印 &quot;Unable to retrieve the address.”。
</code></pre><p><code>john.residence</code>的值现在包含一个<code>Residence</code>实例,然而<code>john.residence.address</code>现在是<code>nil</code>,因此<code>john.residence?.address?.street</code>调用失败。</p>
</code></pre>
<p><code>john.residence</code>的值现在包含一个<code>Residence</code>实例,然而<code>john.residence.address</code>现在是<code>nil</code>,因此<code>john.residence?.address?.street</code>调用失败。</p>
<p>从上面的例子发现,你试图获得<code>street</code>属性值。这个属性的类型是<code>String?</code>。因此尽管在可选类型属性前使用了两层可选链,<code>john.residence?.address?.street</code>的返回值类型也是<code>String?</code></p>
<p>如果你为<code>Address</code>设定一个实例来作为<code>john.residence.address</code>的值,并为<code>address</code><code>street</code>属性设定一个实际值,你可以通过多层可选链来得到这个属性值。</p>
<pre><code>let johnsAddress = Address()
<pre><code class="lang-swift">let johnsAddress = Address()
johnsAddress.buildingName = &quot;The Larches&quot;
johnsAddress.street = &quot;Laurel Street&quot;
john.residence!.address = johnsAddress
if let johnsStreet = john.residence?.address?.street {
</code></pre>
<pre><code class="lang-swift">if let johnsStreet = john.residence?.address?.street {
println(&quot;John&#39;s street name is \(johnsStreet).&quot;)
} else {
println(&quot;Unable to retrieve the address.&quot;)
}
// 打印 &quot;John&#39;s street name is Laurel Street.&quot;
</code></pre><p>值得注意的是,“<code>!</code>”符号在给<code>john.residence.address</code>分配<code>address</code>实例时的使用。<code>john.residence</code>属性是一个可选类型,因此你需要在它获取<code>address</code>属性之前使用<code>!</code>解析以获得它的实际值。</p>
</code></pre>
<p>值得注意的是,“<code>!</code>”符号在给<code>john.residence.address</code>分配<code>address</code>实例时的使用。<code>john.residence</code>属性是一个可选类型,因此你需要在它获取<code>address</code>属性之前使用<code>!</code>解析以获得它的实际值。</p>
<p><a name="chaining_on_methods_with_optional_return_values"></a></p>
<h2 id="-">链接可选返回值的方法</h2>
<p>前面的例子解释了如何通过可选链来获得可选类型属性值。你也可以通过可选链调用一个返回可选类型值的方法并按需链接该方法的返回值。</p>
<p>下面的例子通过可选链调用了<code>Address</code>类中的<code>buildingIdentifier</code> 方法。这个方法的返回值类型是<code>String?</code>。如上所述,这个方法在可选链调用后最终的返回值类型依然是<code>String?</code></p>
<pre><code>if let buildingIdentifier = john.residence?.address?.buildingIdentifier() {
<pre><code class="lang-swift">if let buildingIdentifier = john.residence?.address?.buildingIdentifier() {
println(&quot;John&#39;s building identifier is \(buildingIdentifier).&quot;)
}
// 打印 &quot;John&#39;s building identifier is The Larches.&quot;
</code></pre><p>如果你还想进一步对方法返回值执行可选链,将可选链问号符放在方法括号的后面:</p>
<pre><code>if let upper = john.residence?.address?.buildingIdentifier()?.uppercaseString {
</code></pre>
<p>如果你还想进一步对方法返回值执行可选链,将可选链问号符放在方法括号的后面:</p>
<pre><code class="lang-swift">if let upper = john.residence?.address?.buildingIdentifier()?.uppercaseString {
println(&quot;John&#39;s uppercase building identifier is \(upper).&quot;)
}
// 打印 &quot;John&#39;s uppercase building identifier is THE LARCHES.&quot;
</code></pre><blockquote>
<p>注意:
在上面的例子中,你将可选链问号符放在括号后面是因为你想要链接的可选值是<code>buildingIdentifier</code>方法的返回值,不是<code>buildingIdentifier</code>方法本身。</p>
</code></pre>
<blockquote>
<p>注意:<br>在上面的例子中,你将可选链问号符放在括号后面是因为你想要链接的可选值是<code>buildingIdentifier</code>方法的返回值,不是<code>buildingIdentifier</code>方法本身。</p>
</blockquote>