Merge pull request #563 from 949478479/patch-2

校对 Patterns
This commit is contained in:
overtrue
2015-12-26 12:14:54 +08:00

View File

@ -19,45 +19,47 @@
- [元组模式Tuple Pattern](#tuple_pattern) - [元组模式Tuple Pattern](#tuple_pattern)
- [枚举用例模式Enumeration Case Pattern](#enumeration_case_pattern) - [枚举用例模式Enumeration Case Pattern](#enumeration_case_pattern)
- [可选模式Optional Pattern](#optional_pattern) - [可选模式Optional Pattern](#optional_pattern)
- [类型转换模式Type-Casting Pattern](#type-casting_pattern) - [类型转换模式Type-Casting Pattern](#type-casting_patterns)
- [表达式模式Expression Pattern](#expression_pattern) - [表达式模式Expression Pattern](#expression_pattern)
模式pattern代表单个值或者复合值的结构。例如,元组`(1, 2)`的结构是逗号分隔的,包含两个元素的列表。因为模式代表一种值的结构,而不是特定的某个值,你可以把模式和各种同类型的值匹配起来。比如,`(x, y)`可以匹配元组`(1, 2)`,以及任何含两个元素的元组。除了将模式与一个值匹配外,你可以从复合值中提取出部分或全部,然后分别把各个部分和一个常量或变量绑定起来。 模式代表单个值或者复合值的结构。例如,元组 `(1, 2)` 的结构是逗号分隔的,包含两个元素的列表。因为模式代表一种值的结构,而不是特定的某个值,你可以利用模式来匹配各种各样的值。比如,`(x, y)` 可以匹配元组 `(1, 2)`,以及任何含两个元素的元组。除了利用模式匹配一个值外,你可以从复合值中提取出部分或全部,然后分别把各个部分的值和一个常量或变量绑定起来。
swift语言中模式有2个基本的分类:一能成功和任何值的类型相匹配,另一在运行时runtime和某特定值匹配时可能会失败。 Swift 中的模式分为两类:一能成功匹配任何类型的值,另一在运行时匹配某个特定值时可能会失败。
第一类模式用于解构简单变量常量和可选绑定中的值。此类模式包括通配符模式wildcard patterns标识符模式identifier patterns以及任何包含了它们的值绑定模式value binding patterns或者元祖模式tuple patterns。你可以为这类模式指定一个类型标注type annotation从而限制它们只能匹配某种特定类型的值。 第一类模式用于解构简单变量常量和可选绑定中的值。此类模式包括通配符模式、标识符模式,以及包含前两种模式的值绑定模式和元组模式。你可以为这类模式指定一个类型标注,从而限制它们只能匹配某种特定类型的值。
第二类模式用于全模式匹配,这种情况下你用来相比较的值在运行时可能不存在。此类模式包括枚举用例模式enumeration case patterns可选模式optional patterns表达式模式expression patterns和类型转换模式type-casting patterns。你在`switch`语句的case标签中`do`语句的`catch`句中,或者在`if, while, guard``for-in`语句的case条件句中使用这类模式。 第二类模式用于全模式匹配,这种情况下你试图匹配的值在运行时可能不存在。此类模式包括枚举用例模式、可选模式、表达式模式和类型转换模式。你在 `switch` 语句的 `case` 标签中,`do` 语句的 `catch`句中,或者在 `if``while``guard``for-in` 语句的 `case` 条件句中使用这类模式。
> 模式(Patterns) 语法 > 模式语法
> *模式* → [*通配符模式*](../chapter3/07_Patterns.html#wildcard_pattern) [*类型标注*](../chapter3/03_Types.html#type_annotation) _可选_ <a name="pattern"></a>
> *模式* → [*标识符模式*](../chapter3/07_Patterns.html#identifier_pattern) [*类型标注*](../chapter3/03_Types.html#type_annotati(Value Binding)on) _可选_ > *模式* → [*通配符模式*](#wildcard_pattern) [*类型标注*](03_Types.md#type-annotation)<sub>可选</sub>
> *模式* → [*值绑定模式*](../chapter3/07_Patterns.html#value_binding_pattern) > *模式* → [*标识符模式*](#identifier_pattern) [*类型标注*](03_Types.md#type-annotation)<sub>可选</sub>
> *模式* → [*元组模式*](../chapter3/07_Patterns.html#tuple_pattern) [*类型标注*](../chapter3/03_Types.html#type_annotation) _可选_ > *模式* → [*值绑定模式*](#value-binding-pattern)
> *模式* → [*枚举用例模式*](../chapter3/07_Patterns.html#enum_case_pattern) > *模式* → [*元组模式*](#tuple-pattern) [*类型标注*](03_Types.md#type-annotation)<sub>可选</sub>
> *模式* → [*可选模式*](../chapter3/07_Patterns.html#optional_pattern) > *模式* → [*枚举用例模式*](#enum-case-pattern)
> *模式* → [*类型转换模式*](../chapter3/07_Patterns.html#type_casting_pattern) > *模式* → [*可选模式*](#optional-pattern)
> *模式* → [*表达式模式*](../chapter3/07_Patterns.html#expression_pattern) > *模式* → [*类型转换模式*](#type-casting-pattern)
> *模式* → [*表达式模式*](#expression-pattern)
<a name="wildcard_pattern"></a> <a name="wildcard_pattern"></a>
## 通配符模式Wildcard Pattern ## 通配符模式Wildcard Pattern
通配符模式由一个下划线(_)构成,匹配并忽略任何值。当你不在乎被匹配的值时可以使用该模式。例如,下面这段代码在闭区间`1...3`中循环,每次循环时忽略该区间的当前值: 通配符模式由一个下划线(`_`)构成,用于匹配并忽略任何值。当你想忽略被匹配的值时可以使用该模式。例如,下面这段代码在闭区间 `1...3` 中迭代,每次迭代都忽略该区间的当前值:
```swift ```swift
for _ in 1...3 { for _ in 1...3 {
// Do something three times. // ...
} }
``` ```
> 通配符模式语法 > 通配符模式语法
<a name="wildcard-pattern"></a>
> *通配符模式* → **_** > *通配符模式* → **_**
<a name="identifier_pattern"></a> <a name="identifier_pattern"></a>
## 标识符模式Identifier Pattern ## 标识符模式Identifier Pattern
标识符模式匹配任何值,并将匹配的值和一个变量或常量绑定起来。例如,在下面的常量声明中,`someValue`是一个标识符模式,匹配了类型是`Int``42` 标识符模式匹配任何值,并将匹配的值和一个变量或常量绑定起来。例如,在下面的常量声明中,`someValue` 是一个标识符模式,匹配了 `Int` 类型的 `42`
```swift ```swift
let someValue = 42 let someValue = 42
@ -65,51 +67,53 @@ let someValue = 42
当匹配成功时,`42` 被绑定(赋值)给常量 `someValue` 当匹配成功时,`42` 被绑定(赋值)给常量 `someValue`
如果一个变量或常量声明的左边的模式是一个标识符模式,那么这个标识符模式是一个隐式的值绑定模式value-binding pattern 如果一个变量或常量声明的左边是一个标识符模式,那么这个标识符模式是值绑定模式的子模式
> 标识符模式语法 > 标识符模式语法
> *标识符模式* → [*标识符*](LexicalStructure.html#identifier) <a name="identifier-pattern"></a>
> *标识符模式* → [*标识符*](02_Lexical_Structure.md#identifier)
<a name="value-binding_pattern"></a> <a name="value-binding_pattern"></a>
## 值绑定模式Value-Binding Pattern ## 值绑定模式Value-Binding Pattern
值绑定模式把匹配到的值绑定给一个变量或常量。把绑定匹配到的值绑定给常量时,用关键字`let`,绑定给变量时,用关键字`var` 值绑定模式把匹配到的值绑定给一个变量或常量。把匹配到的值绑定给常量时,用关键字 `let`绑定给变量时,用关键字 `var`
在值绑定模式中的标识符模式会把新命名的变量或常量与匹配值做绑定。例如,你可以拆开一个元组的元素,然后把每个元素绑定到相应一个的标识符模式中。 在值绑定模式中的标识符模式会把新命名的变量或常量与匹配到的值做绑定。例如,你可以拆开一个元组,然后把每个元素绑定到相应的标识符模式中。
```swift ```swift
let point = (3, 2) let point = (3, 2)
switch point { switch point {
// Bind x and y to the elements of point. // 将 point 中的元素绑定到 x 和 y
case let (x, y): case let (x, y):
print("The point is at (\(x), \(y)).") print("The point is at (\(x), \(y)).")
} }
// prints "The point is at (3, 2).” // 打印 “The point is at (3, 2).”
``` ```
在上面这个例子中,`let`元组模式`(x, y)`分配到各个标识符模式。正是由于这么做`switch`语句中`case let (x, y):``case (let x, let y):`匹配到的值是一样的。 在上面这个例子中,`let` 会分配到元组模式 `(x, y)` 中的各个标识符模式。因此`switch` 语句中 `case let (x, y):``case (let x, let y):` 的匹配效果是一样的。
> 值绑定(Value Binding)模式语法 > 值绑定模式语法
> *值绑定模式* → **var** [*模式*](../chapter3/07_Patterns.html#pattern) | **let** [*模式*](../chapter3/07_Patterns.html#pattern) <a name="value-binding-pattern"></a>
> *值绑定模式* → **var** [*模式*](#pattern) | **let** [*模式*](#pattern)
<a name="tuple_pattern"></a> <a name="tuple_pattern"></a>
## 元组模式Tuple Pattern ## 元组模式
元组模式是逗号分隔的,有零个或多个模式的列表,并一对圆括号括起来。元组模式匹配相应元组类型的值。 元组模式是逗号分隔的,有零个或多个模式的列表,并一对圆括号括起来。元组模式匹配相应元组类型的值。
你可以使用类型标注去限制一个元组模式能匹配哪种元组类型。例如,在常量声明`let (x, y): (Int, Int) = (1, 2)`中的元组模式`(x, y): (Int, Int)`只匹配两个元素都是`Int`这种类型的元组。如果仅需要限制一个元组模式中的某几个元素,只需要直接对这几个元素提供类型标注即可。例如,在`let (x: String, y)`中的元组模式可以和任何有两个元素,且第一个元素类型是`String`的元组类型匹配 你可以使用类型标注去限制一个元组模式能匹配哪种元组类型。例如,在常量声明 `let (x, y): (Int, Int) = (1, 2)` 中的元组模式 `(x, y): (Int, Int)` 只匹配两个元素都是 `Int` 类型的元组
当元组模式被用`for-in`语句或者变量常量声明时,它仅可以包含通配符模式标识符模式可选模式或者其他包含这些模式的元模式。比如下面这段代码就不正确,因为`(x, 0)`中的元素`0`是一个表达式模式: 当元组模式被用`for-in` 语句或者变量常量声明时,它仅可以包含通配符模式标识符模式可选模式或者其他包含这些模式的元模式。比如下面这段代码就不正确,因为 `(x, 0)` 中的元素 `0` 是一个表达式模式:
```swift ```swift
let points = [(0, 0), (1, 0), (1, 1), (2, 0), (2, 1)] let points = [(0, 0), (1, 0), (1, 1), (2, 0), (2, 1)]
// This code isn't valid. // 下面的代码是错误的
for (x, 0) in points { for (x, 0) in points {
/* ... */ /* ... */
} }
``` ```
对于只包含一个元素的元组,括号是不起作用的。模式只匹配这个单个元素的类型。举例来说,下面3条语句是等效的: 只包含一个元素的元组模式的圆括号没有效果,模式只匹配这个单个元素的类型。举例来说,下面语句是等效的:
```swift ```swift
let a = 2 // a: Int = 2 let a = 2 // a: Int = 2
@ -118,80 +122,89 @@ let (a): Int = 2 // a: Int = 2
``` ```
> 元组模式语法 > 元组模式语法
> *元组模式* → **(** [*元组模式元素列表*](../chapter3/07_Patterns.html#tuple_pattern_element_list) _可选_ **)** <a name="tuple-pattern"></a>
> *元组模式元素列表* → [*元组模式元素*](../chapter3/07_Patterns.html#tuple_pattern_element) | [*元组模式元素*](../chapter3/07_Patterns.html#tuple_pattern_element) **,** [*元组模式元素列表*](../chapter3/07_Patterns.html#tuple_pattern_element_list) > *元组模式* → **(** [*元组模式元素列表*](#tuple-pattern-element-list)<sub>可选</sub> **)**
> *元组模式元素* → [*模式*](../chapter3/07_Patterns.html#pattern) <a name="tuple-pattern-element-list"></a>
> *元组模式元素列表* → [*元组模式元素*](#tuple-pattern-element) | [*元组模式元素*](#tuple-pattern-element) **,** [*元组模式元素列表*](#tuple-pattern-element-list)
<a name="tuple-pattern-element"></a>
> *元组模式元素* → [*模式*](#pattern)
<a name="enumeration_case_pattern"></a> <a name="enumeration_case_pattern"></a>
## 枚举用例模式Enumeration Case Pattern ## 枚举用例模式Enumeration Case Pattern
一个枚举用例模式匹配现有的某个枚举类型的某个用例case。枚举用例模式出现在`switch`语句中的case标签中以及`if``while``guard``for-in`语句的case条件中。 枚举用例模式匹配现有的某个枚举类型的某个用例。枚举用例模式出现在 `switch` 语句中的 `case` 标签中,以及 `if``while``guard``for-in` 语句的 `case` 条件中。
如果你准备匹配的枚举用例有任何关联的值,则相应的枚举用例模式必须指定一个包含每个关联值元素的元组模式。关于使用`switch`语句来匹配包含关联值枚举用例的例子,请参阅`Associated Values`. 如果你准备匹配的枚举用例有任何关联的值,则相应的枚举用例模式必须指定一个包含每个关联值元素的元组模式。关于使用 `switch` 语句来匹配包含关联值枚举用例的例子,请参阅 [关联值](../chapter2/08_Enumerations.md#associated_values)。
> 枚举用例模式语法 > 枚举用例模式语法
> *enum-case-pattern* → [*类型标识*](../chapter3/03_Types.html#type_identifier) _可选_ **.** [*枚举的case名*](../chapter3/05_Declarations.html#enum_case_name) [*元组模式*](../chapter3/07_Patterns.html#tuple_pattern) _可选_ <a name="enum-case-pattern"></a>
> *枚举用例模式* → [*类型标识*](03_Types.md#type-identifier)<sub>可选</sub> **.** [*枚举用例名*](05_Declarations.md#enum-case-name) [*元组模式*](#tuple-pattern)<sub>可选</sub>
<a name="optional_pattern"></a> <a name="optional_pattern"></a>
## 可选模式Optional Pattern ## 可选模式Optional Pattern
可选模式与封装在一个`Optional(Wrapped)`或者一个`ExplicitlyUnwrappedOptional(Wrapped)`枚举中的`Some(Wrapped)`用例相匹配。可选模式由一个标识符模式和紧随其后的一个问号组成,在某些情况下表现为枚举用例模式。 可选模式匹配包装在一个 `Optional(Wrapped)` 或者 `ExplicitlyUnwrappedOptional(Wrapped)` 枚举中的 `Some(Wrapped)` 用例中的值。可选模式由一个标识符模式和紧随其后的一个问号组成,可以像枚举用例模式一样使用
由于可选模式是`optional``ImplicitlyUnwrappedOptional`枚举用例模式的语法糖syntactic sugar,下面的2种写法是一样的: 由于可选模式是 `Optional``ImplicitlyUnwrappedOptional` 枚举用例模式的语法糖,下面种写法是等效的:
```swift ```swift
let someOptional: Int? = 42 let someOptional: Int? = 42
// Match using an enumeration case pattern // 使用枚举用例模式匹配
if case .Some(let x) = someOptional { if case .Some(let x) = someOptional {
print(x) print(x)
} }
// Match using an optional pattern // 使用可选模式匹配
if case let x? = someOptional { if case let x? = someOptional {
print(x) print(x)
} }
``` ```
如果一个数组的元素是可选类型,可选模式为`for-in`语句提供了一种在该数组中迭代的简便方式,只为数组中的非空`non-nil`元素执行循环体。
可选模式为 `for-in` 语句提供了一种迭代数组的简便方式,只为数组中非 `nil` 的元素执行循环体。
```swift ```swift
let arrayOfOptionalInts: [Int?] = [nil, 2, 3, nil, 5] let arrayOfOptionalInts: [Int?] = [nil, 2, 3, nil, 5]
// Match only non-nil values // 只匹配非 nil 的元素
for case let number? in arrayOfOptinalInts { for case let number? in arrayOfOptinalInts {
print("Found a \(number)") print("Found a \(number)")
} }
// Found a 2 // Found a 2
// Found a 3 // Found a 3
// Found a 5 // Found a 5
``` ```
> 可选模式语法 > 可选模式语法
> *可选模式* → [*标识符模式*](../chapter3/03_Types.html#type_identifier) ? <a name="optional-pattern"></a>
> *可选模式* → [*标识符模式*](03_Types.md#type-identifier) **?**
<a name="type-casting_patterns"></a> <a name="type-casting_patterns"></a>
## 类型转换模式Type-Casting Patterns ## 类型转换模式Type-Casting Patterns
有两种类型转换模式,`is`模式和`as`模式。这两种模式只出现在`switch`语句中的case标签中。`is`模式和`as`模式有以下形式: 有两种类型转换模式,`is` 模式和 `as` 模式。`is` 模式只出现在 `switch` 语句中的 `case` 标签中。`is` 模式和 `as` 模式形式如下
> is `type` > is `类型`
> `pattern` as `type` > `模式` as `类型`
`is`模式仅当一个值的类型在运行时runtime`is`模式右边的指定类型一致 - 或者是该类型的子类 - 的情况下,才会匹配这个值。`is`模式和`is`操作符有相似表现,它们都进行类型转换,却舍弃返回类型。 `is` 模式仅当一个值的类型在运行时和 `is` 模式右边的指定类型一致,或者是其子类的情况下,才会匹配这个值。`is` 模式和 `is` 运算符有相似表现,它们都进行类型转换,但是 `is` 模式没有返回类型。
`as`模式仅当一个值的类型在运行时runtime`as`模式右边的指定类型一致 - 或者是该类型的子类 - 的情况下,才会匹配这个值。如果匹配成功,被匹配的值的类型被转换成`as`模式边指定的模式 `as` 模式仅当一个值的类型在运行时和 `as` 模式右边的指定类型一致,或者是其子类的情况下,才会匹配这个值。如果匹配成功,被匹配的值的类型被转换成 `as` 模式边指定的类型
关于使用`switch`语句来匹`is`模式和`as`模式值的例子,请参阅`Type Casting for Any and AnyObject` 关于使用 `switch` 语句配`is` 模式和 `as` 模式来匹配值的例子,请参阅 [Any 和 AnyObject 的类型转换](../chapter2/19_Type_Casting.md#type_casting_for_any_and_anyobject)
> 类型转换模式语法 > 类型转换模式语法
> *type-casting-pattern* → [*is模式*](../chapter3/07_Patterns.html#is_pattern) | [*as模式*](../chapter3/07_Patterns.html#as_pattern) <a name="type-casting-pattern"></a>
> *is模式* → **is** [*类型*](../chapter3/03_Types.html#type) > *类型转换模式* → [*is模式*](#is-pattern) | [*as模式*](#as-pattern)
> *as模式* → [*模式*](../chapter3/07_Patterns.html#pattern) **as** [*类型*](../chapter3/03_Types.html#type) <a name="is-pattern"></a>
> *is模式* → **is** [*类型*](03_Types.md#type)
<a name="as-pattern"></a>
> *as模式* → [*模式*](#pattern) **as** [*类型*](03_Types.md#type)
<a name="expression_pattern"></a> <a name="expression_pattern"></a>
## 表达式模式Expression Pattern ## 表达式模式Expression Pattern
一个表达式模式代表了一个表达式的值。表达式模式只出现在`switch`语句中的`case`标签中。 表达式模式代表表达式的值。表达式模式只出现在 `switch` 语句中的 `case` 标签中。
表达式模式代表的表达式使用Swift标准库中`~=`操作符的输入表达式的值进行比较。如果`~=`操作符返回`true`,则匹配成功。默认情况下,`~=`操作符使用`==`操作符来比较两个相同类型的值。它也可以将一个整型数值与一个`Range`对象中的一段整数区间做匹配,正如下面这个例子所示: 表达式模式代表的表达式使用 Swift 标准库中`~=` 运算符与输入表达式的值进行比较。如果 `~=` 运算符返回 `true`,则匹配成功。默认情况下,`~=` 运算符使用 `==` 运算符来比较两个相同类型的值。它也可以将一个整型数值与一个 `Range` 实例中的一段整数区间做匹配,正如下面这个例子所示:
```swift ```swift
let point = (1, 2) let point = (1, 2)
@ -203,24 +216,26 @@ case (-2...2, -2...2):
default: default:
print("The point is at (\(point.0), \(point.1)).") print("The point is at (\(point.0), \(point.1)).")
} }
// prints "(1, 2) is near the origin.” // 打印 “(1, 2) is near the origin.”
``` ```
你可以重载`~=`操作符来提供自定义的表达式匹配行为。比如你可以重写上面的例子,`point`表达式去比较字符串形式的点 你可以重载 `~=` 运算符来提供自定义的表达式匹配行为。比如你可以重写上面的例子,`point` 表达式字符串形式表示的点进行比较
```swift ```swift
// Overload the ~= operator to match a string with an integer // 重载 ~= 运算符对字符串和整数进行比较
func ~=(pattern: String, value: Int) -> Bool { func ~=(pattern: String, value: Int) -> Bool {
return pattern == "\(value)" return pattern == "\(value)"
} }
switch point { switch point {
case ("0", "0"): case ("0", "0"):
print("(0, 0) is at the origin.") print("(0, 0) is at the origin.")
default: default:
print("The point is at (\(point.0), \(point.1)).") print("The point is at (\(point.0), \(point.1)).")
} }
// prints "(1, 2) is near the origin.” // 打印 “(1, 2) is near the origin.”
``` ```
> 表达式模式语法 > 表达式模式语法
> *表达式模式* → [*表达式*](../chapter3/04_Expressions.html#expression) <a name="expression-pattern"></a>
> *表达式模式* → [*表达式*](04_Expressions.md#expression)