From a5911a9e43becc79d44ed7a01989af6487ab0fb1 Mon Sep 17 00:00:00 2001 From: stanzhai Date: Sat, 14 Jun 2014 13:33:11 +0800 Subject: [PATCH] modify pattern code style --- source/chapter3/07_Patterns.md | 168 +++++++++++++++------------------ 1 file changed, 75 insertions(+), 93 deletions(-) diff --git a/source/chapter3/07_Patterns.md b/source/chapter3/07_Patterns.md index ae6263ac..31dc2f01 100644 --- a/source/chapter3/07_Patterns.md +++ b/source/chapter3/07_Patterns.md @@ -1,6 +1,6 @@ > 翻译：honghaoz -> 校对：numbbbbb +> 校对：numbbbbb、stanzhai # 模式（Patterns） ----------------- @@ -11,7 +11,7 @@ - [标识符模式（Identifier Pattern）](#identifier_pattern) - [值绑定模式（Value-Binding Pattern）](#value-binding_pattern) - [元组模式（Tuple Pattern）](#tuple_pattern) -- [枚举案例模式（Enumeration Case Pattern）](#enumeration_case_pattern) +- [枚举用例模式（Enumeration Case Pattern）](#enumeration_case_pattern) - [类型转换模式（Type-Casting Patterns）](#type-casting_patterns) - [表达式模式（Expression Pattern）](#expression_pattern) @@ -21,49 +21,40 @@ 你可以为通配符模式（wildcard pattern），标识符模式（identifier pattern）和元组模式（tuple pattern）指定类型注释，用来限制这种模式只匹配某种类型的值。 -> 模式的语法： -> -> pattern → wildcard-patterntype-annotationopt -> -> pattern → identifier-patterntype-annotationopt -> -> pattern → value-binding-pattern -> -> pattern → tuple-patterntype-annotationopt -> -> pattern → enum-case-pattern -> -> pattern → type-casting-pattern -> -> pattern → expression-pattern +> 模式(Patterns) 语法 +> *模式* → [*通配符模式*](..\chapter3\07_Patterns.html#wildcard_pattern) [*类型注解*](..\chapter3\03_Types.html#type_annotation) _可选_ +> *模式* → [*标识符模式*](..\chapter3\07_Patterns.html#identifier_pattern) [*类型注解*](..\chapter3\03_Types.html#type_annotati(Value Binding)on) _可选_ +> *模式* → [*值绑定模式*](..\chapter3\07_Patterns.html#value_binding_pattern) +> *模式* → [*元组模式*](..\chapter3\07_Patterns.html#tuple_pattern) [*类型注解*](..\chapter3\03_Types.html#type_annotation) _可选_ +> *模式* → [*enum-case-pattern*](..\chapter3\07_Patterns.html#enum_case_pattern) +> *模式* → [*type-casting-pattern*](..\chapter3\07_Patterns.html#type_casting_pattern) +> *模式* → [*表达式模式*](..\chapter3\07_Patterns.html#expression_pattern) ## 通配符模式（Wildcard Pattern） 通配符模式匹配并忽略任何值，包含一个下划线（_）。当你不关心被匹配的值时，可以使用此模式。例如，下面这段代码进行了`1...3`的循环，并忽略了每次循环的值： - for _ in 1...3 { - // Do something three times. - } + for _ in 1...3 { + // Do something three times. + } -> 通配符模式的语法： -> -> wildcard-pattern → _ +> 通配符模式语法 +> *通配符模式* → **_** ## 标识符模式（Identifier Pattern） 标识符模式匹配任何值，并将匹配的值和一个变量或常量绑定起来。例如，在下面的常量申明中，`someValue`是一个标识符模式，匹配了类型是`Int`的`42`。 - let someValue = 42 + let someValue = 42 当匹配成功时，`42`被绑定（赋值）给常量`someValue`。 当一个变量或常量申明的左边是标识符模式时，此时，标识符模式是隐式的值绑定模式（value-binding pattern）。 -> 标识符模式的语法： -> -> identifier-pattern → identifier +> 标识符模式语法 +> *标识符模式* → [*标识符*](LexicalStructure.html#identifier) ## 值绑定模式（Value-Binding Pattern） @@ -72,19 +63,18 @@ 标识符模式包含在值绑定模式中，绑定新的变量或常量到匹配的值。例如，你可以分解一个元组的元素，并把每个元素绑定到相应的标识符模式中。 - let point = (3, 2) - switch point { - // Bind x and y to the elements of point. - case let (x, y): - println("The point is at (\(x), \(y)).") - } - // prints "The point is at (3, 2).” + let point = (3, 2) + switch point { + // Bind x and y to the elements of point. + case let (x, y): + println("The point is at (\(x), \(y)).") + } + // prints "The point is at (3, 2).” 在上面这个例子中，`let`将元组模式`(x, y)`分配到各个标识符模式。因为这种行为，`switch`语句中`case let (x, y):`和`case (let x, let y):`匹配的值是一样的。 -> 值绑定模式的语法： -> -> value-binding-pattern → var pattern | let pattern +> 值绑定(Value Binding)模式语法 +> *值绑定模式* → **var** [*模式*](..\chapter3\07_Patterns.html#pattern) | **let** [*模式*](..\chapter3\07_Patterns.html#pattern) ## 元组模式（Tuple Pattern） @@ -95,44 +85,40 @@ 当元组模式被用在`for-in`语句或者变量或常量申明时，它可以包含通配符模式，标识符模式或者其他包含这两种模式的模式。例如，下面这段代码是不正确的，因为`(x, 0)`中的元素`0`是一个表达式模式： - let points = [(0, 0), (1, 0), (1, 1), (2, 0), (2, 1)] - // This code isn't valid. - for (x, 0) in points { - /* ... */ - } + let points = [(0, 0), (1, 0), (1, 1), (2, 0), (2, 1)] + // This code isn't valid. + for (x, 0) in points { + /* ... */ + } 对于只包含一个元素的元组，括号是不起作用的。模式匹配那个单个元素的类型。例如，下面是等效的： - let a = 2 // a: Int = 2 - let (a) = 2 // a: Int = 2 - let (a): Int = 2 // a: Int = 2 + let a = 2 // a: Int = 2 + let (a) = 2 // a: Int = 2 + let (a): Int = 2 // a: Int = 2 -> 元组模式的语法： -> -> tuple-pattern → (tuple-pattern-element-list opt) -> -> tuple-pattern-element-list → tuple-pattern-element | tuple-pattern-element, tuple-pattern-element-list -> -> tuple-pattern-element → pattern +> 元组模式语法 +> *元组模式* → **(** [*元组模式元素列表*](..\chapter3\07_Patterns.html#tuple_pattern_element_list) _可选_ **)** +> *元组模式元素列表* → [*元组模式元素*](..\chapter3\07_Patterns.html#tuple_pattern_element) | [*元组模式元素*](..\chapter3\07_Patterns.html#tuple_pattern_element) **,** [*元组模式元素列表*](..\chapter3\07_Patterns.html#tuple_pattern_element_list) +> *元组模式元素* → [*模式*](..\chapter3\07_Patterns.html#pattern) -## 枚举案例模式（Enumeration Case Pattern） +## 枚举用例模式（Enumeration Case Pattern） -枚举案例模式匹配现有的枚举类型的某种案例。枚举案例模式仅在`switch`语句中的`case`标签中出现。 +枚举用例模式匹配现有的枚举类型的某种用例。枚举用例模式仅在`switch`语句中的`case`标签中出现。 -如果你准备匹配的枚举案例有任何关联的值，则相应的枚举案例模式必须指定一个包含每个关联值元素的元组模式。关于使用`switch`语句来匹配包含关联值枚举案例的例子，请参阅`Associated Values`. +如果你准备匹配的枚举用例有任何关联的值，则相应的枚举用例模式必须指定一个包含每个关联值元素的元组模式。关于使用`switch`语句来匹配包含关联值枚举用例的例子，请参阅`Associated Values`. -> 枚举案例模式的语法： -> -> enum-case-pattern → type-identifier opt . enum-case-name tuple-pattern opt +> 枚举用例模式语法 +> *enum-case-pattern* → [*类型标识*](..\chapter3\03_Types.html#type_identifier) _可选_ **.** [*枚举的case名*](..\chapter3\05_Declarations.html#enum_case_name) [*元组模式*](..\chapter3\07_Patterns.html#tuple_pattern) _可选_ ## 类型转换模式（Type-Casting Patterns） 有两种类型转换模式，`is`模式和`as`模式。这两种模式均只出现在`switch`语句中的`case`标签中。`is`模式和`as`模式有以下形式： - is type - pattern as type + is type + pattern as type `is`模式匹配一个值，如果这个值的类型在运行时（runtime）和`is`模式右边的指定类型（或者那个类型的子类）是一致的。`is`模式和`is`操作符一样，他们都进行类型转换，但是抛弃了返回的类型。 @@ -140,13 +126,10 @@ 关于使用`switch`语句来匹配`is`模式和`as`模式值的例子，请参阅`Type Casting for Any and AnyObject`。 -> 类型转换模式的语法： -> -> type-casting-pattern → is-pattern as-pattern -> -> is-pattern → istype -> -> as-pattern → patternastype +> 类型转换模式语法 +> *type-casting-pattern* → [*is模式*](..\chapter3\07_Patterns.html#is_pattern) | [*as模式*](..\chapter3\07_Patterns.html#as_pattern) +> *is模式* → **is** [*类型*](..\chapter3\03_Types.html#type) +> *as模式* → [*模式*](..\chapter3\07_Patterns.html#pattern) **as** [*类型*](..\chapter3\03_Types.html#type) ## 表达式模式（Expression Pattern） @@ -155,34 +138,33 @@ 由表达式模式所代表的表达式用Swift标准库中的`~=`操作符与输入表达式的值进行比较。如果`~=`操作符返回`true`，则匹配成功。默认情况下，`~=`操作符使用`==`操作符来比较两个相同类型的值。它也可以匹配一个整数值与一个`Range`对象中的整数范围，正如下面这个例子所示： - let point = (1, 2) - switch point { - case (0, 0): - println("(0, 0) is at the origin.") - case (-2...2, -2...2): - println("(\(point.0), \(point.1)) is near the origin.") - default: - println("The point is at (\(point.0), \(point.1)).") - } - // prints "(1, 2) is near the origin.” + let point = (1, 2) + switch point { + case (0, 0): + println("(0, 0) is at the origin.") + case (-2...2, -2...2): + println("(\(point.0), \(point.1)) is near the origin.") + default: + println("The point is at (\(point.0), \(point.1)).") + } + // prints "(1, 2) is near the origin.” 你可以重载`~=`操作符来提供自定义的表达式行为。例如，你可以重写上面的例子，以实现用字符串表达的点来比较`point`表达式。 - // Overload the ~= operator to match a string with an integer - func ~=(pattern: String, value: Int) -> Bool { - return pattern == "\(value)" - } - switch point { - case ("0", "0"): - println("(0, 0) is at the origin.") - case ("-2...2", "-2...2"): - println("(\(point.0), \(point.1)) is near the origin.") - default: - println("The point is at (\(point.0), \(point.1)).") - } - // prints "(1, 2) is near the origin.” + // Overload the ~= operator to match a string with an integer + func ~=(pattern: String, value: Int) -> Bool { + return pattern == "\(value)" + } + switch point { + case ("0", "0"): + println("(0, 0) is at the origin.") + case ("-2...2", "-2...2"): + println("(\(point.0), \(point.1)) is near the origin.") + default: + println("The point is at (\(point.0), \(point.1)).") + } + // prints "(1, 2) is near the origin.” -> 表达式模式的语法： -> -> expression-pattern → expression +> 表达式模式语法 +> *表达式模式* → [*表达式*](..\chapter3\04_Expressions.html#expression)