make gitbook

2014-06-14 20:51:32 +08:00
parent e00caf63d5
commit 31f083eb83
68 changed files with 1893 additions and 1795 deletions
--- a/chapter2/08_Enumerations.html
+++ b/chapter2/08_Enumerations.html
@ -46,7 +46,7 @@


        
-    <div class="book"  data-level="2.8" data-basepath=".." data-revision="1402677669306">
+    <div class="book"  data-level="2.8" data-basepath=".." data-revision="1402750255397">
    <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>
@ -268,7 +268,7 @@
        <li class="chapter " data-level="2.12" data-path="chapter2/12_Subscripts.html">
            
            <a href="../chapter2/12_Subscripts.html">
-                <i class="fa fa-check"></i> <b>2.12.</b> 附属脚本
+                <i class="fa fa-check"></i> <b>2.12.</b> 下标脚本
            </a>
            
            
@ -520,7 +520,7 @@
    
        <a href="../chapter2/11_Methods.html" title="方法" class="chapter done " data-progress="2.11" style="left: 18.42105263157895%;"></a>
    
-        <a href="../chapter2/12_Subscripts.html" title="附属脚本" class="chapter done " data-progress="2.12" style="left: 21.05263157894737%;"></a>
+        <a href="../chapter2/12_Subscripts.html" title="下标脚本" class="chapter done " data-progress="2.12" style="left: 21.05263157894737%;"></a>
    
        <a href="../chapter2/13_Inheritance.html" title="继承" class="chapter done " data-progress="2.13" style="left: 23.68421052631579%;"></a>
    
@ -587,11 +587,10 @@

                <div class="page-inner">
                
-                    <section class="normal" id="section-gitbook_102">
+                    <section class="normal" id="section-gitbook_49">
                    
                        <blockquote>
-<p>翻译：yankuangshi</p>
-<p>校对：shinyzhu</p>
+<p>翻译：yankuangshi<br>校对：shinyzhu  </p>
 </blockquote>
 <h1 id="-enumerations-">枚举（Enumerations）</h1>
 <hr>
@ -610,34 +609,38 @@
 <p><a name="enumeration_syntax"></a></p>
 <h2 id="-">枚举语法</h2>
 <p>使用<code>enum</code>关键词并且把它们的整个定义放在一对大括号内：</p>
-<pre><code>enum SomeEumeration {
-    // enumeration definition goes here
+<pre><code class="lang-swift">enum SomeEumeration {
+  // enumeration definition goes here
 }
-</code></pre><p>以下是指南针四个方向的一个例子：</p>
-<pre><code>enum CompassPoint {
-    case North
-    case South
-    case East
-    case West
+</code></pre>
+<p>以下是指南针四个方向的一个例子：</p>
+<pre><code class="lang-swift">enum CompassPoint {
+  case North
+  case South
+  case East
+  case West
 }
-</code></pre><p>一个枚举中被定义的值（例如 <code>North</code>，<code>South</code>，<code>East</code>和<code>West</code>）是枚举的<strong><em>成员值</em></strong>（或者<strong><em>成员</em></strong>）。<code>case</code>关键词表明新的一行成员值将被定义。</p>
+</code></pre>
+<p>一个枚举中被定义的值（例如 <code>North</code>，<code>South</code>，<code>East</code>和<code>West</code>）是枚举的<strong><em>成员值</em></strong>（或者<strong><em>成员</em></strong>）。<code>case</code>关键词表明新的一行成员值将被定义。</p>
 <blockquote>
-<p>注意：</p>
-<p>不像 C 和 Objective-C 一样，Swift 的枚举成员在被创建时不会被赋予一个默认的整数值。在上面的<code>CompassPoints</code>例子中，<code>North</code>，<code>South</code>，<code>East</code>和<code>West</code>不是隐式的等于<code>0</code>，<code>1</code>，<code>2</code>和<code>3</code>。相反的，这些不同的枚举成员在<code>CompassPoint</code>的一种显示定义中拥有各自不同的值。</p>
+<p>注意：<br>不像 C 和 Objective-C 一样，Swift 的枚举成员在被创建时不会被赋予一个默认的整数值。在上面的<code>CompassPoints</code>例子中，<code>North</code>，<code>South</code>，<code>East</code>和<code>West</code>不是隐式的等于<code>0</code>，<code>1</code>，<code>2</code>和<code>3</code>。相反的，这些不同的枚举成员在<code>CompassPoint</code>的一种显示定义中拥有各自不同的值。  </p>
 </blockquote>
 <p>多个成员值可以出现在同一行上，用逗号隔开：</p>
-<pre><code>enum Planet {
-    case Mercury, Venus, Earth, Mars, Jupiter, Saturn, Uranus, Nepturn
+<pre><code class="lang-swift">enum Planet {
+  case Mercury, Venus, Earth, Mars, Jupiter, Saturn, Uranus, Nepturn
 }
-</code></pre><p>每个枚举定义了一个全新的类型。像 Swift 中其他类型一样，它们的名字（例如<code>CompassPoint</code>和<code>Planet</code>）必须以一个大写字母开头。给枚举类型起一个单数名字而不是复数名字，以便于读起来更加容易理解：</p>
-<pre><code>var directionToHead = CompassPoint.West
-</code></pre><p><code>directionToHead</code>的类型被推断当它被<code>CompassPoint</code>的一个可能值初始化。一旦<code>directionToHead</code>被声明为一个<code>CompassPoint</code>，你可以使用更短的点（.）语法将其设置为另一个<code>CompassPoint</code>的值：</p>
-<pre><code>directionToHead = .East
-</code></pre><p><code>directionToHead</code>的类型已知时，当设定它的值时，你可以不再写类型名。使用显示类型的枚举值可以让代码具有更好的可读性。</p>
+</code></pre>
+<p>每个枚举定义了一个全新的类型。像 Swift 中其他类型一样，它们的名字（例如<code>CompassPoint</code>和<code>Planet</code>）必须以一个大写字母开头。给枚举类型起一个单数名字而不是复数名字，以便于读起来更加容易理解：</p>
+<pre><code class="lang-swift">var directionToHead = CompassPoint.West
+</code></pre>
+<p><code>directionToHead</code>的类型被推断当它被<code>CompassPoint</code>的一个可能值初始化。一旦<code>directionToHead</code>被声明为一个<code>CompassPoint</code>，你可以使用更短的点（.）语法将其设置为另一个<code>CompassPoint</code>的值：</p>
+<pre><code class="lang-swift">directionToHead = .East
+</code></pre>
+<p><code>directionToHead</code>的类型已知时，当设定它的值时，你可以不再写类型名。使用显示类型的枚举值可以让代码具有更好的可读性。</p>
 <p><a name="matching_enumeration_values_with_a_switch_statement"></a></p>
 <h2 id="-switch-">匹配枚举值和<code>Switch</code>语句</h2>
 <p>你可以匹配单个枚举值和<code>switch</code>语句：</p>
-<pre><code>directionToHead = .South
+<pre><code class="lang-swift">directionToHead = .South
 switch directionToHead {
 case .North:
    println(&quot;Lots of planets have a north&quot;)
@ -649,12 +652,13 @@ case .West:
    println(&quot;Where the skies are blue&quot;)
 }
 // 输出 &quot;Watch out for penguins”
-</code></pre><p>你可以如此理解这段代码：</p>
+</code></pre>
+<p>你可以如此理解这段代码：</p>
 <p>“考虑<code>directionToHead</code>的值。当它等于<code>.North</code>，打印<code>“Lots of planets have a north”</code>。当它等于<code>.South</code>，打印<code>“Watch out for penguins”</code>。”</p>
 <p>等等依次类推。</p>
 <p>正如在<a href="05_Control_Flow.html">控制流（Control Flow）</a>中介绍，当考虑一个枚举的成员们时，一个<code>switch</code>语句必须全面。如果忽略了<code>.West</code>这种情况，上面那段代码将无法通过编译，因为它没有考虑到<code>CompassPoint</code>的全部成员。全面性的要求确保了枚举成员不会被意外遗漏。</p>
 <p>当不需要匹配每个枚举成员的时候，你可以提供一个默认<code>default</code>分支来涵盖所有未明确被提出的任何成员：</p>
-<pre><code>let somePlanet = Planet.Earth
+<pre><code class="lang-swift">let somePlanet = Planet.Earth
 switch somePlanet {
 case .Earth:
    println(&quot;Mostly harmless&quot;)
@ -662,7 +666,8 @@ default:
    println(&quot;Not a safe place for humans&quot;)
 }
 // 输出 &quot;Mostly harmless”
-</code></pre><p><a name="associated_values"></a></p>
+</code></pre>
+<p><a name="associated_values"></a></p>
 <h2 id="-associated-values-">实例值（Associated Values）</h2>
 <p>上一小节的例子演示了一个枚举的成员是如何被定义（分类）的。你可以为<code>Planet.Earth</code>设置一个常量或则变量，并且在之后查看这个值。然而，有时候会很有用如果能够把其他类型的实例值和成员值一起存储起来。这能让你随着成员值存储额外的自定义信息，并且当每次你在代码中利用该成员时允许这个信息产生变化。</p>
 <p>你可以定义 Swift 的枚举存储任何类型的实例值，如果需要的话，每个成员的数据类型可以是各不相同的。枚举的这种特性跟其他语言中的可辨识联合（discriminated unions），标签联合（tagged unions），或者变体（variants）相似。</p>
@ -672,61 +677,70 @@ default:
 <p><img width="169" height="169" alt="" src="https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/Art/barcode_QR_2x.png"></p>
 <p>对于库存跟踪系统来说，能够把 UPC-A 码作为三个整型值的元组，和把 QR 码作为一个任何长度的字符串存储起来是方便的。</p>
 <p>在 Swift 中，用来定义两种商品条码的枚举是这样子的：</p>
-<pre><code>enum Barcode {
-    case UPCA(Int, Int, Int)
-    case QRCode(String)
+<pre><code class="lang-swift">enum Barcode {
+  case UPCA(Int, Int, Int)
+  case QRCode(String)
 }
-</code></pre><p>以上代码可以这么理解：</p>
+</code></pre>
+<p>以上代码可以这么理解：</p>
 <p>“定义一个名为<code>Barcode</code>的枚举类型，它可以是<code>UPCA</code>的一个实例值（<code>Int</code>，<code>Int</code>，<code>Int</code>），或者<code>QRCode</code>的一个字符串类型（<code>String</code>）实例值。”</p>
 <p>这个定义不提供任何<code>Int</code>或<code>String</code>的实际值，它只是定义了，当<code>Barcode</code>常量和变量等于<code>Barcode.UPCA</code>或<code>Barcode.QRCode</code>时，实例值的类型。</p>
 <p>然后可以使用任何一种条码类型创建新的条码，如：</p>
-<pre><code>var productBarcode = Barcode.UPCA(8, 85909_51226, 3)
-</code></pre><p>以上例子创建了一个名为<code>productBarcode</code>的新变量，并且赋给它一个<code>Barcode.UPCA</code>的实例元组值<code>(8, 8590951226, 3)</code>。提供的“标识符”值在整数字中有一个下划线，使其便于阅读条形码。</p>
+<pre><code class="lang-swift">var productBarcode = Barcode.UPCA(8, 85909_51226, 3)
+</code></pre>
+<p>以上例子创建了一个名为<code>productBarcode</code>的新变量，并且赋给它一个<code>Barcode.UPCA</code>的实例元组值<code>(8, 8590951226, 3)</code>。提供的“标识符”值在整数字中有一个下划线，使其便于阅读条形码。</p>
 <p>同一个商品可以被分配给一个不同类型的条形码，如：</p>
-<pre><code>productBarcode = .QRCode(&quot;ABCDEFGHIJKLMNOP&quot;)
-</code></pre><p>这时，原始的<code>Barcode.UPCA</code>和其整数值被新的<code>Barcode.QRCode</code>和其字符串值所替代。条形码的常量和变量可以存储一个<code>.UPCA</code>或者一个<code>.QRCode</code>（连同它的实例值），但是在任何指定时间只能存储其中之一。</p>
+<pre><code class="lang-swift">productBarcode = .QRCode(&quot;ABCDEFGHIJKLMNOP&quot;)
+</code></pre>
+<p>这时，原始的<code>Barcode.UPCA</code>和其整数值被新的<code>Barcode.QRCode</code>和其字符串值所替代。条形码的常量和变量可以存储一个<code>.UPCA</code>或者一个<code>.QRCode</code>（连同它的实例值），但是在任何指定时间只能存储其中之一。</p>
 <p>像以前那样，不同的条形码类型可以使用一个 switch 语句来检查，然而这次实例值可以被提取作为 switch 语句的一部分。你可以在<code>switch</code>的 case 分支代码中提取每个实例值作为一个常量（用<code>let</code>前缀）或者作为一个变量（用<code>var</code>前缀）来使用：</p>
-<pre><code>switch productBarcode {
+<pre><code class="lang-swift">switch productBarcode {
 case .UPCA(let numberSystem, let identifier, let check):
    println(&quot;UPC-A with value of \(numberSystem), \(identifier), \(check).&quot;)
 case .QRCode(let productCode):
    println(&quot;QR code with value of \(productCode).&quot;)
 }
 // 输出 &quot;QR code with value of ABCDEFGHIJKLMNOP.”
-</code></pre><p>如果一个枚举成员的所有实例值被提取为常量，或者它们全部被提取为变量，为了简洁，你可以只放置一个<code>var</code>或者<code>let</code>标注在成员名称前：</p>
-<pre><code>switch productBarcode {
+</code></pre>
+<p>如果一个枚举成员的所有实例值被提取为常量，或者它们全部被提取为变量，为了简洁，你可以只放置一个<code>var</code>或者<code>let</code>标注在成员名称前：</p>
+<pre><code class="lang-swift">switch productBarcode {
 case let .UPCA(numberSystem, identifier, check):
    println(&quot;UPC-A with value of \(numberSystem), \(identifier), \(check).&quot;)
 case let .QRCode(productCode):
    println(&quot;QR code with value of \(productCode).&quot;)
 }
 // 输出 &quot;QR code with value of ABCDEFGHIJKLMNOP.&quot;
-</code></pre><p><a name="raw_values"></a></p>
+</code></pre>
+<p><a name="raw_values"></a></p>
 <h2 id="-raw-values-">原始值（Raw Values）</h2>
 <p>在实例值小节的条形码例子中演示了一个枚举的成员如何声明它们存储不同类型的实例值。作为实例值的替代，枚举成员可以被默认值（称为原始值）预先填充，其中这些原始值具有相同的类型。</p>
 <p>这里是一个枚举成员存储原始 ASCII 值的例子：</p>
-<pre><code>enum ASCIIControlCharacter: Character {
+<pre><code class="lang-swift">enum ASCIIControlCharacter: Character {
    case Tab = &quot;\t&quot;
    case LineFeed = &quot;\n&quot;
    case CarriageReturn = &quot;\r&quot;
 }
-</code></pre><p>在这里，称为<code>ASCIIControlCharacter</code>的枚举的原始值类型被定义为字符型<code>Character</code>，并被设置了一些比较常见的 ASCII 控制字符。字符值的描述请详见字符串和字符<code>Strings and Characters</code>部分。</p>
+</code></pre>
+<p>在这里，称为<code>ASCIIControlCharacter</code>的枚举的原始值类型被定义为字符型<code>Character</code>，并被设置了一些比较常见的 ASCII 控制字符。字符值的描述请详见字符串和字符<code>Strings and Characters</code>部分。</p>
 <p>注意，原始值和实例值是不相同的。当你开始在你的代码中定义枚举的时候原始值是被预先填充的值，像上述三个 ASCII 码。对于一个特定的枚举成员，它的原始值始终是相同的。实例值是当你在创建一个基于枚举成员的新常量或变量时才会被设置，并且每次当你这么做得时候，它的值可以是不同的。</p>
 <p>原始值可以是字符串，字符，或者任何整型值或浮点型值。每个原始值在它的枚举声明中必须是唯一的。当整型值被用于原始值，如果其他枚举成员没有值时，它们会自动递增。</p>
 <p>下面的枚举是对之前<code>Planet</code>这个枚举的一个细化，利用原始整型值来表示每个 planet 在太阳系中的顺序：</p>
-<pre><code>enum Planet: Int {
+<pre><code class="lang-swift">enum Planet: Int {
    case Mercury = 1, Venus, Earth, Mars, Jupiter, Saturn, Uranus, Neptune
 }
-</code></pre><p>自动递增意味着<code>Planet.Venus</code>的原始值是<code>2</code>，依次类推。</p>
+</code></pre>
+<p>自动递增意味着<code>Planet.Venus</code>的原始值是<code>2</code>，依次类推。</p>
 <p>使用枚举成员的<code>toRaw</code>方法可以访问该枚举成员的原始值：</p>
-<pre><code>let earthsOrder = Planet.Earth.toRaw()
+<pre><code class="lang-swift">let earthsOrder = Planet.Earth.toRaw()
 // earthsOrder is 3
-</code></pre><p>使用枚举的<code>fromRaw</code>方法来试图找到具有特定原始值的枚举成员。这个例子通过原始值<code>7</code>识别<code>Uranus</code>：</p>
-<pre><code>let possiblePlanet = Planet.fromRaw(7)
+</code></pre>
+<p>使用枚举的<code>fromRaw</code>方法来试图找到具有特定原始值的枚举成员。这个例子通过原始值<code>7</code>识别<code>Uranus</code>：</p>
+<pre><code class="lang-swift">let possiblePlanet = Planet.fromRaw(7)
 // possiblePlanet is of type Planet? and equals Planet.Uranus
-</code></pre><p>然而，并非所有可能的<code>Int</code>值都可以找到一个匹配的行星。正因为如此，<code>fromRaw</code>方法可以返回一个<strong><em>可选</em></strong>的枚举成员。在上面的例子中，<code>possiblePlanet</code>是<code>Planet?</code>类型，或“可选的<code>Planet</code>”。</p>
+</code></pre>
+<p>然而，并非所有可能的<code>Int</code>值都可以找到一个匹配的行星。正因为如此，<code>fromRaw</code>方法可以返回一个<strong><em>可选</em></strong>的枚举成员。在上面的例子中，<code>possiblePlanet</code>是<code>Planet?</code>类型，或“可选的<code>Planet</code>”。</p>
 <p>如果你试图寻找一个位置为9的行星，通过<code>fromRaw</code>返回的可选<code>Planet</code>值将是<code>nil</code>：</p>
-<pre><code>let positionToFind = 9
+<pre><code class="lang-swift">let positionToFind = 9
 if let somePlanet = Planet.fromRaw(positionToFind) {
    switch somePlanet {
    case .Earth:
@ -738,7 +752,8 @@ if let somePlanet = Planet.fromRaw(positionToFind) {
    println(&quot;There isn&#39;t a planet at position \(positionToFind)&quot;)
 }
 // 输出 &quot;There isn&#39;t a planet at position 9
-</code></pre><p>这个范例使用可选绑定（optional binding），通过原始值<code>9</code>试图访问一个行星。<code>if let somePlanet = Planet.fromRaw(9)</code>语句获得一个可选<code>Planet</code>，如果可选<code>Planet</code>可以被获得，把<code>somePlanet</code>设置成该可选<code>Planet</code>的内容。在这个范例中，无法检索到位置为<code>9</code>的行星，所以<code>else</code>分支被执行。</p>
+</code></pre>
+<p>这个范例使用可选绑定（optional binding），通过原始值<code>9</code>试图访问一个行星。<code>if let somePlanet = Planet.fromRaw(9)</code>语句获得一个可选<code>Planet</code>，如果可选<code>Planet</code>可以被获得，把<code>somePlanet</code>设置成该可选<code>Planet</code>的内容。在这个范例中，无法检索到位置为<code>9</code>的行星，所以<code>else</code>分支被执行。</p>

                    
                    </section>