andre/the-swift-programming-language-in-chinese
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

update anchor

Browse Source
This commit is contained in:
Jie Liang
2019-04-02 09:40:12 -05:00
parent 61e3a3243f
commit 5d3bf7bbcf
8 changed files with 714 additions and 357 deletions
Download Patch File Download Diff File Expand all files Collapse all files

156
source/chapter3/02_Lexical_Structure.md
View File

@ -14,7 +14,8 @@ Swift 的*“词法结构（lexical structure）”* 描述了能构成该语言
>
> *空白* → [*空白项*](#whitespace-item) [*空白*](#whitespace)<sub>可选</sub>
>
> ###### whitespace-item {# whitespace-item}
>
#### whitespace-item {# whitespace-item}
>
> *空白项* → [*断行符*](#line-break)
>
@ -24,7 +25,8 @@ Swift 的*“词法结构（lexical structure）”* 描述了能构成该语言
>
> *空白项* → U+0000，U+0009，U+000B，U+000C 或者 U+0020
>
> ###### line-break {# line-break}
>
#### line-break {# line-break}
>
> *断行符* → U+000A
>
@ -32,23 +34,28 @@ Swift 的*“词法结构（lexical structure）”* 描述了能构成该语言
>
> *断行符* → U+000D 接着是 U+000A
>
> ###### comment {# comment}
>
#### comment {# comment}
>
> *注释* → // [*注释内容*](#comment-text) [断行符*](#line-break)
>
> ###### multiline-comment {# multiline-comment}
>
#### multiline-comment {# multiline-comment}
>
> *多行注释* → `/*` [*多行注释内容*](#multiline-commnet-text) `*/`
>
> ###### comment-text {# comment-text}
>
#### comment-text {# comment-text}
>
> *注释内容* → [*注释内容项*](#comment-text-item) [*注释内容*](#comment-text)<sub>可选</sub>
>
> ###### comment-text-item {# comment-text-item}
>
#### comment-text-item {# comment-text-item}
>
> *注释内容项* → 任何 Unicode 标量值， 除了 U+000A 或者 U+000D
>
> ###### multiline-commnet-text {# multiline-commnet-text}
>
#### multiline-commnet-text {# multiline-commnet-text}
>
> *多行注释内容* → [*多行注释内容项*](#multiline-comment-text-item) [*多行注释内容*](#multiline-comment-text)<sub>可选</sub>
>
@ -76,7 +83,8 @@ Swift 的*“词法结构（lexical structure）”* 描述了能构成该语言
>
> *标识符列表* → [*标识符*](#identifier) | [*标识符*](#identifier) **,** [*标识符列表*](#identifier)
>
> ###### identifier-head {# identifier-head}
>
#### identifier-head {# identifier-head}
>
> *头部标识符* → 大写或小写字母 A - Z
>
@ -112,17 +120,20 @@ Swift 的*“词法结构（lexical structure）”* 描述了能构成该语言
>
> *标识符字符* → 数值 0 - 9
>
> ###### identifier-character {# identifier-character}
>
#### identifier-character {# identifier-character}
>
> *标识符字符* → U+0300–U+036F，U+1DC0–U+1DFF，U+20D0–U+20FF，或者 U+FE20–U+FE2F
>
> *标识符字符* → [*头部标识符*](#identifier-head)
>
> ###### identifier-characters {# identifier-characters}
>
#### identifier-characters {# identifier-characters}
>
> *标识符字符组* → [*标识符字符*](#identifier-character) [*标识符字符组*](#identifier-characters)<sub>可选</sub>
>
> ###### implicit-parameter-name {# implicit-parameter-name}
>
#### implicit-parameter-name {# implicit-parameter-name}
>
> *隐式参数名* → **$** [*十进制数字列表*](#decimal-digit)
@ -181,7 +192,8 @@ true // 布尔值字面量
> 整数字面量语法
>
> ###### integer-literal {# integer-literal}
>
#### integer-literal {# integer-literal}
>
> *整数字面量* → [*二进制字面量*](#binary-literal)
>
@ -191,43 +203,52 @@ true // 布尔值字面量
>
> *整数字面量* → [*十六进制字面量*](#hexadecimal-literal)
>
> ###### binary-literal {# binary-literal}
>
#### binary-literal {# binary-literal}
>
> *二进制字面量* → **0b** [*二进制数字*](#binary-digit) [*二进制字面量字符组*](#binary-literal-characters)<sub>可选</sub>
>
> ###### binary-digit {# binary-digit}
>
#### binary-digit {# binary-digit}
>
> *二进制数字* → 数值 0 到 1
>
> *二进制字面量字符* → [*二进制数字*](#binary-digit) | _
>
> ###### binary-literal-characters {# binary-literal-characters}
>
#### binary-literal-characters {# binary-literal-characters}
>
> *二进制字面量字符组* → [*二进制字面量字符*](#binary-literal-character) [*二进制字面量字符组*](#binary-literal-characters)<sub>可选</sub>
>
> ###### octal-literal {# octal-literal}
>
#### octal-literal {# octal-literal}
>
> *八进制字面量* → **0o** [*八进字数字*](#octal-digit) [*八进制字符组*](#octal-literal-characters)<sub>可选</sub>
>
> ###### octal-digit {# octal-digit}
>
#### octal-digit {# octal-digit}
>
> *八进字数字* → 数值 0 到 7
>
> *八进制字符* → [*八进字数字*](#octal-digit) | _
>
> ###### octal-literal-characters {# octal-literal-characters}
>
#### octal-literal-characters {# octal-literal-characters}
>
> *八进制字符组* → [*八进制字符*](#octal-literal-character) [*八进制字符组*](#octal-literal-characters)<sub>可选</sub>
>
> ###### decimal-literal {# decimal-literal}
>
#### decimal-literal {# decimal-literal}
>
> *十进制字面量* → [*十进制数字*](#decimal-digit) [*十进制字符组*](#decimal-literal-characters)<sub>可选</sub>
>
> ###### decimal-digit {# decimal-digit}
>
#### decimal-digit {# decimal-digit}
>
> *十进制数字* → 数值 0 到 9
>
> ###### decimal-literal-characters {# decimal-literal-characters}
>
#### decimal-literal-characters {# decimal-literal-characters}
>
> *十进制数字组* → [*十进制数字*](#decimal-digit) [*十进制数字组*](#decimal-literal-characters)<sub>可选</sub>
>
@ -235,17 +256,20 @@ true // 布尔值字面量
>
> *十进制字符组* → [*十进制字符*](#decimal-literal-characters) [*十进制字符组*](#decimal-literal-characters)<sub>可选</sub>
>
> ###### hexadecimal-literal {# hexadecimal-literal}
>
#### hexadecimal-literal {# hexadecimal-literal}
>
> *十六进制字面量* → **0x** [*十六进制数字*](#hexadecimal-digit) [*十六进制字面量字符组*](#hexadecimal-literal-characters)<sub>可选</sub>
>
> ###### hexadecimal-digit {# hexadecimal-digit}
>
#### hexadecimal-digit {# hexadecimal-digit}
>
> *十六进制数字* → 数值 0 到 9, 字母 a 到 f, 或 A 到 F
>
> *十六进制字符* → [*十六进制数字*](#hexadecimal-digit) | _
>
> ###### hexadecimal-literal-characters {# hexadecimal-literal-characters}
>
#### hexadecimal-literal-characters {# hexadecimal-literal-characters}
>
> *十六进制字面量字符组* → [*十六进制字符*](#hexadecimal-literal-characters) [*十六进制字面量字符组*](#hexadecimal-literal-characters)<sub>可选</sub>
@ -267,37 +291,45 @@ true // 布尔值字面量
> 浮点数字面量语法
>
> ###### floating-point-literal {# floating-point-literal}
>
#### floating-point-literal {# floating-point-literal}
>
> *浮点数字面量* → [*十进制字面量*](#decimal-literal) [*十进制分数*](#decimal-fraction)<sub>可选</sub> [*十进制指数*](#decimal-exponent)<sub>可选</sub>
>
> *浮点数字面量* → [*十六进制字面量*](#hexadecimal-literal) [*十六进制分数*](#hexadecimal-fraction)<sub>可选</sub> [*十六进制指数*](#hexadecimal-exponent)
>
> ###### decimal-fraction {# decimal-fraction}
>
#### decimal-fraction {# decimal-fraction}
>
> *十进制分数* → **.** [*十进制字面量*](#decimal-literal)
>
> ###### decimal-exponent {# decimal-exponent}
>
#### decimal-exponent {# decimal-exponent}
>
> *十进制指数* → [*十进制指数 e*](#floating-point-e) [*正负号*](#sign)<sub>可选</sub> [*十进制字面量*](#decimal-literal)
>
> ###### hexadecimal-fraction {# hexadecimal-fraction}
>
#### hexadecimal-fraction {# hexadecimal-fraction}
>
> *十六进制分数* → **.** [*十六进制数字*](#hexadecimal-digit) [*十六进制字面量字符组*](#hexadecimal-literal-characters)<sub>可选</sub>
>
> ###### hexadecimal-exponent {# hexadecimal-exponent}
>
#### hexadecimal-exponent {# hexadecimal-exponent}
>
> *十六进制指数* → [*十六进制指数 p*](#floating-point-p) [*正负号*](#sign)<sub>可选</sub> [*十进制字面量*](#decimal-literal)
>
> ###### floating-point-e {# floating-point-e}
>
#### floating-point-e {# floating-point-e}
>
> *十进制指数 e* → **e** | **E**
>
> ###### floating-point-p {# floating-point-p}
>
#### floating-point-p {# floating-point-p}
>
> *十六进制指数 p* → **p** | **P**
>
> ###### sign {# sign}
>
#### sign {# sign}
>
> *正负号* → **+** | **-**
@ -398,7 +430,8 @@ let textB = "Hello world"
>
> *字符串闭分隔定界符* → **"** [*字符串扩展分隔符*](#extended-string-literal-delimiter)<sub>可选</sub>
>
> ###### static-string-literal {# static-string-literal}
>
#### static-string-literal {# static-string-literal}
>
> *静态字符串字面量* → [*字符串开分隔定界符*](#extended-string-literal-delimiter) [*引用文本*](#quoted-text)<sub>可选</sub> [*字符串闭分隔定界符*](#extended-string-literal-delimiter)
>
@ -408,45 +441,54 @@ let textB = "Hello world"
>
> *多行字符串闭分隔定界符* → **"""** [*字符串扩展分隔符*](#extended-string-literal-delimiter)
>
> ###### extended-string-literal-delimiter {# extended-string-literal-delimiter}
>
#### extended-string-literal-delimiter {# extended-string-literal-delimiter}
>
> *字符串扩展分隔符* → **#** [*字符串扩展分隔符*](#extended-string-literal-delimiter)<sub>可选</sub>
>
> ###### quoted-text {# quoted-text}
>
#### quoted-text {# quoted-text}
>
> *引用文本* → [*引用文本项*](#quoted-text-item) [*引用文本*](#quoted-text)<sub>可选</sub>
>
> ###### quoted-text-item {# quoted-text-item}
>
#### quoted-text-item {# quoted-text-item}
>
> *引用文本项* → [*转义字符*](#escaped-character)
>
> *引用文本项* → 除了 **"**、**\\**、U+000A、U+000D 以外的所有 Unicode 字符
>
> ###### multiline-quoted-text {# multiline-quoted-text}
>
#### multiline-quoted-text {# multiline-quoted-text}
>
> *多行引用文本* → [*多行引用文本项*](#multiline-quoted-text-item) [*多行引用文本*](#multiline-quoted-text)<sub>可选</sub>
>
> ###### multiline-quoted-text-item {# multiline-quoted-text-item}
>
#### multiline-quoted-text-item {# multiline-quoted-text-item}
>
> *多行引用文本项* [*转义字符*](#escaped-character)<sub>可选</sub>
>
> ###### multiline-quoted-text {# multiline-quoted-text}
>
#### multiline-quoted-text {# multiline-quoted-text}
>
> *多行引用文本* → 除了 **\** 以外的任何Unicode标量值
>
> *多行引用文本* → [*转义换行*](#escaped-newline)
>
> ###### interpolated-string-literal {# interpolated-string-literal}
>
#### interpolated-string-literal {# interpolated-string-literal}
>
> *插值字符串字面量* → [*字符串开分隔定界符*](#extended-string-literal-delimiter) [*插值文本*](#interpolated-text)<sub>可选</sub> [*字符串闭分隔定界符*](#extended-string-literal-delimiter)
>
> *插值字符串字面量* → [*多行字符串开分隔定界符*](#extended-string-literal-delimiter) [*插值文本*](#interpolated-text)<sub>可选</sub> [*多行字符串闭分隔定界符*](#extended-string-literal-delimiter)
>
> ###### interpolated-text {# interpolated-text}
>
#### interpolated-text {# interpolated-text}
>
> *插值文本* → [*插值文本项*](#interpolated-text-item) [*插值文本*](#interpolated-text)<sub>可选</sub>
>
> ###### interpolated-text-item {# interpolated-text-item}
>
#### interpolated-text-item {# interpolated-text-item}
>
> *插值文本项* → **\\****(**[*表达式*](./04_Expressions.md)**)** | [*引用文本项*](#quoted-text-item)
>
@ -454,21 +496,25 @@ let textB = "Hello world"
>
> *多行插值文本项* → **\\(** [表达式](./04_Expressions.md) **)** | [多行引用文本项](#multiline-quoted-text-item)
>
> ###### escape-sequence {# escape-sequence}
>
#### escape-sequence {# escape-sequence}
>
> *转义序列* → **\\** [字符串扩展分隔符](#extended-string-literal-delimiter)
>
> ###### escaped-character {# escaped-character}
>
#### escaped-character {# escaped-character}
>
> *转义字符* → [*转义序列*](#escape-sequence) **0** | [*转义序列*](#escape-sequence) **\\** | [*转义序列*](#escape-sequence) **t** | [*转义序列*](#escape-sequence) **n** | [*转义序列*](#escape-sequence) **r** | [*转义序列*](#escape-sequence) **\"** | [*转义序列*](#escape-sequence) **'**
>
> *转义字符* → [*转义序列*](#escape-sequence) **u {** [*unicode 标量数字*](#unicode-scalar-digits) **}**
>
> ###### unicode-scalar-digits {# unicode-scalar-digits}
>
#### unicode-scalar-digits {# unicode-scalar-digits}
>
> *unicode 标量数字* → 一到八位的十六进制数字
>
> ###### escaped-newline {# escaped-newline}
>
#### escaped-newline {# escaped-newline}
>
> *转义换行符* → [*转义序列*](#escape-sequence) [*空白*](#whitespace)<sub>可选</sub> [*断行符*](#line-break)
@ -508,7 +554,8 @@ Swift 标准库定义了许多可供使用的运算符，其中大部分在 [基
>
> *运算符* → [*头部点运算符*](#dot-operator-head) [*点运算符字符组*](#dot-operator-characters)
>
> ###### operator-head {# operator-head}
>
#### operator-head {# operator-head}
>
> *头部运算符* → **/** | **=** | **-** | **+** | **!** | __*__ | **%** | **<** | **>** | **&** | **|** | **^** | **~** | **?**
>
@ -540,7 +587,8 @@ Swift 标准库定义了许多可供使用的运算符，其中大部分在 [基
>
> *头部运算符* → U+3008–U+3030
>
> ###### operator-character {# operator-character}
>
#### operator-character {# operator-character}
>
> *运算符字符* → [*头部运算符*](#operator-head)
>
@ -556,19 +604,23 @@ Swift 标准库定义了许多可供使用的运算符，其中大部分在 [基
>
> *运算符字符* → U+E0100–U+E01EF
>
> ###### operator-characters {# operator-characters}
>
#### operator-characters {# operator-characters}
>
> *运算符字符组* → [*运算符字符*](#operator-character) [*运算符字符组*](#operator-characters)<sub>可选</sub>
>
> ###### dot-operator-head {# dot-operator-head}
>
#### dot-operator-head {# dot-operator-head}
>
> *头部点运算符* → **..**
>
> ###### dot-operator-character {# dot-operator-character}
>
#### dot-operator-character {# dot-operator-character}
>
> *点运算符字符* → **.** | [*运算符字符*](#operator-character)
>
> ###### dot-operator-characters {# dot-operator-characters}
>
#### dot-operator-characters {# dot-operator-characters}
>
> *点运算符字符组* → [*点运算符字符*](#dot-operator-character) [*点运算符字符组*](#dot-operator-characters)<sub>可选</sub>
>

69
source/chapter3/03_Types.md
View File

@ -27,7 +27,8 @@ Swift 语言存在两种类型：命名型类型和复合型类型。*命名型
> 类型语法
>
###### type {#type}
#### type {#type}
> *类型* → [*数组类型*](#array-type)
>
> *类型* → [*字典类型*](#dictionary-type)
@ -67,7 +68,8 @@ func someFunction(a: Int) { /* ... */ }
> 类型注解语法
>
###### type-annotation {#type-annotation}
#### type-annotation {#type-annotation}
> *类型注解* → **:** [*特性列表*](./07_Attributes.md#attributes)<sub>可选</sub> **输入输出参数**<sub>可选</sub> [*类型*](#type)
>
@ -91,10 +93,12 @@ var someValue: ExampleModule.MyType
> 类型标识符语法
>
###### type-identifier {#type-identifier}
#### type-identifier {#type-identifier}
> *类型标识符* → [*类型名称*](#type-name) [*泛型参数子句*](./09_Generic_Parameters_and_Arguments.md#generic_argument_clause)<sub>可选</sub> | [*类型名称*](#type-name) [*泛型参数子句*](./09_Generic_Parameters_and_Arguments.md#generic_argument_clause)<sub>可选</sub> **.** [*类型标识符*](#type-identifier)
>
###### type-name {#type-name}
#### type-name {#type-name}
> *类型名称* → [*标识符*](./02_Lexical_Structure.md#identifier)
>
@ -116,16 +120,20 @@ someTuple = (left: 5, right: 5) // 错误：命名类型不匹配
> 元组类型语法
>
###### tuple-type {#tuple-type}
#### tuple-type {#tuple-type}
> *元组类型* → **(** **)** | **(** [*元组类型元素*](#tuple-type-element) **,** [*元组类型元素列表*](#tuple-type-element-list) **)**
>
###### tuple-type-element-list {#tuple-type-element-list}
#### tuple-type-element-list {#tuple-type-element-list}
> *元组类型元素列表* → [*元组类型元素*](#tuple-type-element) | [*元组类型元素*](#tuple-type-element) **,** [*元组类型元素列表*](#tuple-type-element-list)
>
###### tuple-type-element {#tuple-type-element}
#### tuple-type-element {#tuple-type-element}
> *元组类型元素* → [*元素名*](#element-name) [*类型注解*](#type-annotation) | [*类型*](#type)
>
###### element-name {#element-name}
#### element-name {#element-name}
> *元素名* → [*标识符*](./02_Lexical_Structure.md#identifier)
>
@ -202,22 +210,27 @@ func takesTwoFunctions(first: (Any) -> Void, second: (Any) -> Void) {
> 函数类型语法
>
###### function-type {#function-type}
#### function-type {#function-type}
> *函数类型* → [*特性列表*](./07_Attributes.md#attributes)<sub>可选</sub> [*函数类型子句*](#function-type-argument-clause) **throws**<sub>可选</sub> **->** [*类型*](#type)
>
> *函数类型* → [*特性列表*](./07_Attributes.md#attributes)<sub>可选</sub> [*函数类型子句*](#function-type-argument-clause) **rethrows­** **->** [*类型*](#type)
>
###### function-type-argument-clause {#function-type-argument-clause}
#### function-type-argument-clause {#function-type-argument-clause}
> *函数类型子句* → **(**­ **)**­
> *函数类型子句* → **(** [*函数类型参数列表*](#function-type-argument-list) *...*­ <sub>可选</sub> **)**
>
###### function-type-argument-list {#function-type-argument-list}
#### function-type-argument-list {#function-type-argument-list}
> *函数类型参数列表* → [*函数类型参数*](function-type-argument) | [*函数类型参数*](function-type-argument)， [*函数类型参数列表*](#function-type-argument-list)
>
###### function-type-argument {#function-type-argument}
#### function-type-argument {#function-type-argument}
> *函数类型参数* → [*特性列表*](./07_Attributes.md#attributes)<sub>可选</sub> **输入输出参数**<sub>可选</sub> [*类型*](#type) | [*参数标签*](#argument-label) [*类型注解*](#type-annotation)
>
###### argument-label {#argument-label}
#### argument-label {#argument-label}
> *参数标签* → [*标识符*](./02_Lexical_Structure.md#identifier)
>
@ -248,7 +261,8 @@ var array3D: [[[Int]]] = [[[1, 2], [3, 4]], [[5, 6], [7, 8]]]
> 数组类型语法
>
###### array-type {#array-type}
#### array-type {#array-type}
> *数组类型* → **[** [*类型*](#type) **]**
>
@ -275,7 +289,8 @@ let someDictionary: Dictionary<String, Int> = ["Alex": 31, "Paul": 39]
> 字典类型语法
>
###### dictionary-type {#dictionary-type}
#### dictionary-type {#dictionary-type}
> *字典类型* → **[** [*类型*](#type) **:** [*类型*](#type) **]**
>
@ -306,7 +321,8 @@ optionalInteger! // 42
> 可选类型语法
>
###### optional-type {#optional-type}
#### optional-type {#optional-type}
> *可选类型* → [*类型*](#type) **?**
>
@ -340,7 +356,8 @@ let implicitlyUnwrappedArray: [Int]! // 正确
> 隐式解析可选类型语法
>
###### implicitly-unwrapped-optional-type {#implicitly-unwrapped-optional-type}
#### implicitly-unwrapped-optional-type {#implicitly-unwrapped-optional-type}
> *隐式解析可选类型* → [*类型*](#type) **!**
>
@ -369,10 +386,12 @@ typealias PQR = PQ & Q & R
> 协议合成类型语法
>
###### protocol-composition-type {#protocol-composition-type}
#### protocol-composition-type {#protocol-composition-type}
> *协议合成类型* → [*协议标识符*](#protocol-identifier) & [*协议合成延续*](#protocol-composition-continuation)
>
###### protocol-composition-continuation {#protocol-composition-continuation}
#### protocol-composition-continuation {#protocol-composition-continuation}
> *协议合成延续* → [*协议标识符*](#protocol-identifier) | [*协议合成类型*](#protocol-composition-type)
>
@ -421,7 +440,8 @@ let anotherInstance = metatype.init(string: "some string")
> 元类型语法
>
###### metatype-type {#metatype-type}
#### metatype-type {#metatype-type}
> *元类型* → [*类型*](#type) **.** **Type** | [*类型*](#type) **.** **Protocol**
>
@ -436,13 +456,16 @@ let anotherInstance = metatype.init(string: "some string")
> 类型继承子句语法
>
###### type_inheritance_clause {#type_inheritance_clause}
#### type_inheritance_clause {#type_inheritance_clause}
> *类型继承子句* → **:** [*类型继承列表*](#type-inheritance-list)
>
###### type-inheritance-list {#type-inheritance-list}
#### type-inheritance-list {#type-inheritance-list}
> *类型继承列表* → [*类型标识符*](#type-identifier) | [*类型标识符*](#type-identifier) **,** [*类型继承列表*](#type-inheritance-list)
>
###### class-requirement {#class-requirement}
#### class-requirement {#class-requirement}
## 类型推断 {#type_inference}

183
source/chapter3/04_Expressions.md
View File

@ -6,10 +6,12 @@ Swift 中存在四种表达式：前缀表达式，二元表达式，基本表
> 表达式语法
>
###### expression {#expression}
#### expression {#expression}
> *表达式* → [*try 运算符*](#try-operator)<sub>可选</sub> [*前缀表达式*](#prefix-expression) [*二元表达式列表*](#binary-expressions)<sub>可选</sub>
>
###### expression-list {#expression-list}
#### expression-list {#expression-list}
> *表达式列表* → [*表达式*](#expression) | [*表达式*](#expression) **,** [*表达式列表*](#expression-list)
>
@ -24,12 +26,14 @@ Swift 中存在四种表达式：前缀表达式，二元表达式，基本表
> 前缀表达式语法
>
###### prefix-expression {#prefix-expression}
#### prefix-expression {#prefix-expression}
> *前缀表达式* → [*前缀运算符*](./02_Lexical_Structure.md#prefix-operator)<sub>可选</sub> [*后缀表达式*](#postfix-expression)
>
> *前缀表达式* → [*输入输出表达式*](#in-out-expression)
>
###### in-out-expression {#in-out-expression}
#### in-out-expression {#in-out-expression}
> *输入输出表达式* → **&** [*标识符*](./02_Lexical_Structure.md#identifier)
>
@ -66,7 +70,8 @@ sum = (try someThrowingFunction()) + anotherThrowingFunction() // 错误：try
关于 `try`、`try?` 和 `try!` 的更多信息，以及该如何使用的例子，请参阅 [错误处理](../chapter2/17_Error_Handling.md)。
> Try 表达式语法
>
###### try-operator {#try-operator}
#### try-operator {#try-operator}
> *try 运算符* → **try** | **try?** | **try!**
>
@ -85,7 +90,8 @@ sum = (try someThrowingFunction()) + anotherThrowingFunction() // 错误：try
> 在解析时，一个二元表达式将作为一个扁平列表表示，然后根据运算符的优先级，再进一步进行组合。例如，`2 + 3 * 5` 首先被看作具有五个元素的列表，即 `2`、`+`、`3`、`*`、`5`，随后根据运算符优先级组合为 `(2 + (3 * 5))`。
>
###### binary-expression {#binary-expression}
#### binary-expression {#binary-expression}
> 二元表达式语法
>
> *二元表达式* → [*二元运算符*](./02_Lexical_Structure.md#binary-operator) [*前缀表达式*](#prefix-expression)
@ -96,7 +102,8 @@ sum = (try someThrowingFunction()) + anotherThrowingFunction() // 错误：try
>
> *二元表达式* → [*类型转换运算符*](#type-casting-operator)
>
###### binary-expressions {#binary-expressions}
#### binary-expressions {#binary-expressions}
> *二元表达式列表* → [*二元表达式*](#binary-expression) [*二元表达式列表*](#binary-expressions)<sub>可选</sub>
>
@ -117,7 +124,8 @@ sum = (try someThrowingFunction()) + anotherThrowingFunction() // 错误：try
> 赋值运算符语法
>
###### assignment-operator {#assignment-operator}
#### assignment-operator {#assignment-operator}
> *赋值运算符* → **=**
>
@ -133,7 +141,8 @@ sum = (try someThrowingFunction()) + anotherThrowingFunction() // 错误：try
> 三元条件运算符语法
>
###### conditional-operator {#conditional-operator}
#### conditional-operator {#conditional-operator}
> *三元条件运算符* → **?** [*表达式*](#expression) **:**
>
@ -176,7 +185,8 @@ f(x as Any)
关于类型转换的更多内容和例子，请参阅 [类型转换](../chapter2/18_Type_Casting.md)。
###### type-casting-operator {#type-casting-operator}
#### type-casting-operator {#type-casting-operator}
> 类型转换运算符语法
>
> *类型转换运算符* → **is** [*类型*](./03_Types.md#type)
@ -193,7 +203,8 @@ f(x as Any)
> 基本表达式语法
>
###### primary-expression {#primary-expression}
#### primary-expression {#primary-expression}
> *基本表达式* → [*标识符*](./02_Lexical_Structure.md#identifier) [*泛型实参子句*](./09_Generic_Parameters_and_Arguments.md#generic-argument-clause)<sub>可选</sub>
>
> *基本表达式* → [*字面量表达式*](#literal-expression)
@ -269,7 +280,8 @@ Xcode 使用 playground 字面量对程序编辑器中的颜色、文件或者
> 字面量表达式语法
>
>
> ###### literal-expression {#literal-expression}
>
#### literal-expression {#literal-expression}
>
> *字面量表达式* → [*字面量*](./02_Lexical_Structure.md#literal)
>
@ -279,38 +291,46 @@ Xcode 使用 playground 字面量对程序编辑器中的颜色、文件或者
>
> ###### array-literal {#array-literal}
>
#### array-literal {#array-literal}
>
> *数组字面量* → [[*数组字面量项列表*](#array-literal-items)<sub>可选</sub> **]**
>
> ###### array-literal-items {#array-literal-items}
>
#### array-literal-items {#array-literal-items}
>
> *数组字面量项列表* → [*数组字面量项*](#array-literal-item) **,**<sub>可选</sub> | [*数组字面量项*](#array-literal-item) **,** [*数组字面量项列表*](#array-literal-items)
>
> ###### array-literal-item {#array-literal-item}
>
#### array-literal-item {#array-literal-item}
>
> *数组字面量项* → [*表达式*](#expression)
>
>
> ###### dictionary-literal {#dictionary-literal}
>
#### dictionary-literal {#dictionary-literal}
>
> *字典字面量* → [[*字典字面量项列表*](#dictionary-literal-items) **]** | **[** **:** **]**
>
> ###### dictionary-literal-items {#dictionary-literal-items}
>
#### dictionary-literal-items {#dictionary-literal-items}
>
> *字典字面量项列表* → [*字典字面量项*](#dictionary-literal-item) **,**<sub>可选</sub> | [*字典字面量项*](#dictionary-literal-item) **,** [*字典字面量项列表*](#dictionary-literal-items)
>
> ###### dictionary-literal-item {#dictionary-literal-item}
>
#### dictionary-literal-item {#dictionary-literal-item}
>
> *字典字面量项* → [*表达式*](#expression) **:** [*表达式*](#expression)。
>
> ###### playground-literal {#playground-literal}
>
#### playground-literal {#playground-literal}
>
> *playground 字面量* → **#colorLiteral ( red : [*表达式*](#expression) , green :[*表达式*](#expression) [*表达式*](#e[*表达式*](#expression) xpression) , blue :[*表达式*](#expression) , alpha : [*表达式*](#expression) )**
>
> *playground 字面量* → **#fileLiteral ( resourceName : [*表达式*](#expression) )**
>
> ###### playground 字面量* → **#imageLiteral ( resourceName : [*表达式*](#expression) )**self_expression {#self_expression}
>
#### playground 字面量* → **#imageLiteral ( resourceName : [*表达式*](#expression) )**self_expression {#self_expression}
>
### Self 表达式
@ -354,17 +374,21 @@ struct Point {
> Self 表达式语法
>
###### self-expression {#self-expression}
#### self-expression {#self-expression}
> *self 表达式* → **self** | [*self 方法表达式*](#self-method-expression) ｜ [*self 下标表达式*](#self-subscript-expression) | [*self 构造器表达式*](#self-initializer-expression)
>
>
###### self-method-expression {#self-method-expression}
#### self-method-expression {#self-method-expression}
> *self 方法表达式* → **self** **.** [*标识符*](./02_Lexical_Structure.md#identifier)
>
###### self-subscript-expression {#self-subscript-expression}
#### self-subscript-expression {#self-subscript-expression}
> *self 下标表达式* → **self** **[** [*函数调用参数表*](#function-call-argument-list­) **]**
>
###### self-initializer-expression {#self-initializer-expression}
#### self-initializer-expression {#self-initializer-expression}
> *self 构造器表达式* → **self** **.** **init**
>
@ -384,16 +408,20 @@ struct Point {
> 父类表达式语法
>
###### superclass-expression {#superclass-expression}
#### superclass-expression {#superclass-expression}
> *父类表达式* → [*父类方法表达式*](#superclass-method-expression) | [*父类下标表达式*](#superclass-subscript-expression) | [*父类构造器表达式*](#superclass-initializer-expression)
>
###### superclass-method-expression {#superclass-method-expression}
#### superclass-method-expression {#superclass-method-expression}
> *父类方法表达式* → **super** **.** [*标识符*](./02_Lexical_Structure.md#identifier)
>
###### superclass-subscript-expression {#superclass-subscript-expression}
#### superclass-subscript-expression {#superclass-subscript-expression}
> *父类下标表达式* → **super** [[*函数调用参数表*](#function-call-argument-list­) **]**
>
###### superclass-initializer-expression {#superclass-initializer-expression}
#### superclass-initializer-expression {#superclass-initializer-expression}
> *父类构造器表达式* → **super** **.** **init**
>
@ -501,12 +529,14 @@ myFunction { [weak parent = self.parent] in print(parent!.title) }
> 闭包表达式语法
>
>
> ###### closure-expression {#closure-expression}
>
#### closure-expression {#closure-expression}
>
> *闭包表达式* → **{** [*闭包签名*](#closure-signature)<sub>可选</sub> [*语句*](#statements) **}**
>
>
> ###### closure-signature {#closure-signature}
>
#### closure-signature {#closure-signature}
>
>
> 闭包签名* → [*参数子句*](#parameter-clause) [*函数结果*](05_Declarations.md#function-result)<sub>可选</sub> **in**
@ -520,20 +550,24 @@ myFunction { [weak parent = self.parent] in print(parent!.title) }
> *闭包签名* → [*捕获列表*](#capture-list) **in**
>
>
> ###### capture-list {#capture-list}
>
#### capture-list {#capture-list}
>
>
> 捕获列表* → [ [*捕获列表项列表*](#capture-list-items) **]**
>
> ###### capture-list-items {#capture-list-items}
>
#### capture-list-items {#capture-list-items}
>
> *捕获列表项列表* → [*捕获列表项*](#capture-list-item) | [*捕获列表项*](#capture-list-item) **,** [*捕获列表项列表*](#capture-list-items)
>
> ###### capture-list-item {#capture-list-item}
>
#### capture-list-item {#capture-list-item}
>
> *捕获列表项* → [*捕获说明符*](#capture-specifier)<sub>可选</sub> [*表达式*](#expression)
>
> ###### capture-specifier {#capture-specifier}
>
#### capture-specifier {#capture-specifier}
>
> *捕获说明符* → **weak** | **unowned** | **unowned(safe)** | **unowned(unsafe)**
>
@ -553,7 +587,8 @@ x = .AnotherValue
> 隐式成员表达式语法
>
###### implicit-member-expression {#implicit-member-expression}
#### implicit-member-expression {#implicit-member-expression}
> *隐式成员表达式* → **.** [*标识符*](./02_Lexical_Structure.md#identifier)
>
@ -562,7 +597,8 @@ x = .AnotherValue
> 圆括号表达式语法
>
###### parenthesized-expression {#parenthesized-expression}
#### parenthesized-expression {#parenthesized-expression}
> *圆括号表达式* → **( [*表达式*](#expression) )**
>
@ -583,13 +619,16 @@ x = .AnotherValue
> 元组表达式语法
>
###### tuple-expression {#tuple-expression}
#### tuple-expression {#tuple-expression}
> *元组表达式* → **( )** | **(**[*元组元素*](#tuple-element)， [*元组元素列表*](#tuple-element-list) **)**
>
###### tuple-element-list {#tuple-element-list}
#### tuple-element-list {#tuple-element-list}
> *元组元素列表* → [*元组元素*](#tuple-element) | [*元组元素*](#tuple-element) **,** [*元组元素列表*](#tuple-element-list)
>
###### tuple-element {#tuple-element}
#### tuple-element {#tuple-element}
> *元组元素* → [*表达式*](#expression) | [*标识符*](identifier) **:** [*表达式*](#expression)
>
@ -603,7 +642,8 @@ x = .AnotherValue
> 通配符表达式语法
>
###### wildcard-expression {#wildcard-expression}
#### wildcard-expression {#wildcard-expression}
> *通配符表达式* → **_**
>
@ -740,21 +780,26 @@ print(interestingNumbers[keyPath: \[String: [Int]].["hexagonal"]!.count.bitWidth
> key-path 表达式语法
>
>
> ###### key-path-expression {#key-path-expression}
>
#### key-path-expression {#key-path-expression}
>
> *key-path 表达式* → **\\** [类型](./03_Types.md#type)<sub>可选</sub> **.** [多个 key-path 组件](#key-path-components)
>
> ###### key-path-components {#key-path-components}
>
#### key-path-components {#key-path-components}
>
> *多个 key-path 组件* → [key-path 组件](#key-path-component) | [key-path 组件](#key-path-component) **.** [多个 key-path 组件](#key-path-components)
>
> ###### key-path-component {#key-path-component}
>
#### key-path-component {#key-path-component}
>
> *key-path 组件* → [标识符](./02_Lexical_Structure.md#identifier) [多个 key-path 后缀](#key-path-postfixes)<sub>可选<sub> | [多个 key-path 后缀](#key-path-postfixes)
>
> ###### key-path-postfixes {#key-path-postfixes}
>
> ###### *多个 key-path 后缀* → [key-path 后缀](#key-path-postfix) [多个 key-path 后缀](#key-path-postfixes)<sub>可选<sub> key-path-postfixes {#key-path-postfixes}
#### key-path-postfixes {#key-path-postfixes}
>
>
#### *多个 key-path 后缀* → [key-path 后缀](#key-path-postfix) [多个 key-path 后缀](#key-path-postfixes)<sub>可选<sub> key-path-postfixes {#key-path-postfixes}
>
> *key-path 后缀* → **?** | **!** | **self** | **\[** [函数调用参数表](#function-call-argument-list) **\]**
>
@ -809,7 +854,8 @@ let anotherSelector = #selector(SomeClass.doSomething(_:) as (SomeClass) -> (Str
> 选择器表达式语法
>
###### selector-expression {#selector-expression}
#### selector-expression {#selector-expression}
> *选择器表达式* → __#selector__ **(** [*表达式*](#expression) **)**
>
> *选择器表达式* → __#selector__ **(** [*getter:表达式*](#expression) **)**
@ -867,7 +913,8 @@ print(keyPath == c.getSomeKeyPath())
> key-path 字符串表达式语法
>
> ###### key-path-string-expression {#key-path-string-expression}
>
#### key-path-string-expression {#key-path-string-expression}
>
> *key-path 字符串表达式* → **#keyPath (** [表达式](#expression) **)**
>
@ -881,7 +928,8 @@ print(keyPath == c.getSomeKeyPath())
> 后缀表达式语法
>
###### postfix-expression {#postfix-expression}
#### postfix-expression {#postfix-expression}
> *后缀表达式* → [*基本表达式*](#primary-expression)
>
> *后缀表达式* → [*后缀表达式*](#postfix-expression) [*后缀运算符*](02_Lexical_Structure.md#postfix-operator)
@ -934,29 +982,34 @@ myData.someMethod {$0 == 13}
> 函数调用表达式语法
>
> ###### function-call-expression {#function-call-expression}
>
#### function-call-expression {#function-call-expression}
>
> *函数调用表达式* → [*后缀表达式*](#postfix-expression) [*函数调用参数子句*](#function-call-argument-clause)
>
> *函数调用表达式* → [*后缀表达式*](#postfix-expression) [*函数调用参数子句*](#function-call-argument-clause)<sub>可选</sub> [*尾随闭包*](#trailing-closure)
>
>
> ###### function-call-argument-clause {#function-call-argument-clause}
>
#### function-call-argument-clause {#function-call-argument-clause}
>
> *函数调用参数子句* → **(** **)** | **(** [*函数调用参数表*](#function-call-argument-list) **)**
>
> ###### function-call-argument-list {#function-call-argument-list}
>
#### function-call-argument-list {#function-call-argument-list}
>
> *函数调用参数表* → [函数调用参数](#function-call-argument) | [函数调用参数](#function-call-argument) **,** [*函数调用参数表*](#function-call-argument-list)
>
> ###### function-call-argument {#function-call-argument}
>
#### function-call-argument {#function-call-argument}
>
> *函数调用参数* → [表达式](#expression) | [标识符](02_Lexical_Structure.md#identifier) **:** [*表达式*](#expression)
>
> *函数调用参数* → [运算符](./02_Lexical_Structure.md#operator) | [标识符](./02_Lexical_Structure.md#identifier) **:** [*运算符*](./02_Lexical_Structure.md#operator)
>
>
> ###### trailing-closure {#trailing-closure}
>
#### trailing-closure {#trailing-closure}
>
> *尾随闭包* → [*闭包表达式*](#closure-expression)
>
@ -1001,7 +1054,8 @@ let s3 = someValue.dynamicType.init(data: 7) // 有效
> 构造器表达式语法
>
###### initializer-expression {#initializer-expression}
#### initializer-expression {#initializer-expression}
> *构造器表达式* → [*后缀表达式*](#postfix-expression) **.** **init**
>
> *构造器表达式* → [*后缀表达式*](#postfix-expression) **.** **init** **(** [*参数名称*](#argument-names) **)**
@ -1067,17 +1121,20 @@ let x = [10, 3, 20, 15, 4]
> 显式成员表达式语法
>
###### explicit-member-expression {#explicit-member-expression}
#### explicit-member-expression {#explicit-member-expression}
> *显式成员表达式* → [*后缀表达式*](#postfix-expression) **.** [*十进制数字*] (02_Lexical_Structure.md#decimal-digit)
>
> *显式成员表达式* → [*后缀表达式*](#postfix-expression) **.** [*标识符*](02_Lexical_Structure.md#identifier) [*泛型实参子句*](./09_Generic_Parameters_and_Arguments.md#generic-argument-clause)<sub>可选</sub><br/>
>
> *显式成员表达式* → [*后缀表达式*](#postfix-expression) **.** [*标识符*] (02_Lexical_Structure.md#identifier) **(** [*参数名称*](#argument-names) **)**
>
###### argument-names {#argument-names}
#### argument-names {#argument-names}
> *参数名称* → [*参数名*](#argument-name) [*参数名称*](#argument-names)<sub>可选</sub><br/>
>
###### argument-name {#argument-name}
#### argument-name {#argument-name}
> *参数名* → [*标识符*](./02_Lexical_Structure.md#identifier) **:**
>
@ -1095,7 +1152,8 @@ let x = [10, 3, 20, 15, 4]
> 后缀 self 表达式语法
>
###### postfix-self-expression {#postfix-self-expression}
#### postfix-self-expression {#postfix-self-expression}
> *后缀 self 表达式* → [*后缀表达式*](#postfix-expression) **.** **self**
>
@ -1112,7 +1170,8 @@ let x = [10, 3, 20, 15, 4]
> 下标表达式语法
>
###### subscript-expression {#subscript-expression}
#### subscript-expression {#subscript-expression}
> *下标表达式* → [*后缀表达式*](#postfix-expression) **[** [*表达式列表*](#expression-list) **]**
>
@ -1138,7 +1197,8 @@ someDictionary["a"]![0] = 100
> 强制取值语法
>
###### forced-value-expression {#forced-value-expression}
#### forced-value-expression {#forced-value-expression}
> *强制取值表达式* → [*后缀表达式*](#postfix-expression) **!**
>
@ -1190,6 +1250,7 @@ someDictionary["a"]?[0] = someFunctionWithSideEffects()
> 可选链表达式语法
>
###### optional-chaining-expression {#optional-chaining-expression}
#### optional-chaining-expression {#optional-chaining-expression}
> *可选链表达式* → [*后缀表达式*](#postfix-expression) **?**
>

213
source/chapter3/05_Statements.md
View File

@ -8,7 +8,8 @@
> 语句语法
>
###### statement {#statement}
#### statement {#statement}
> *语句* → [*表达式*](./04_Expressions.md#expression) **;**<sub>可选</sub>
>
> *语句* → [*声明*](./06_Declarations.md#declaration) **;**<sub>可选</sub>
@ -27,7 +28,8 @@
>
> *语句* → [*编译器控制语句*](#compiler-control-statement)
>
###### statements {#statements}
#### statements {#statements}
> *多条语句* → [*语句*](#statement) [*多条语句*](#statements)<sub>可选</sub>
>
@ -39,7 +41,8 @@
> 循环语句语法
>
>
###### loop-statement {#loop-statement}
#### loop-statement {#loop-statement}
> *循环语句* → [*for-in 语句*](#for-in-statement)
>
> *循环语句* → [*while 语句*](#while-statement)
@ -64,7 +67,8 @@ for item in collection {
> for-in 语句语法
>
>
###### for-in-statement {#for-in-statement}
#### for-in-statement {#for-in-statement}
> *for-in 语句* → **for** **case**<sub>可选</sub> [*模式*](./08_Patterns.md#pattern) **in** [*表达式*](./04_Expressions.md#expression) [*where 子句*](#where-clause)<sub>可选</sub> [*代码块*](05_Declarations.md#code-block)
>
@ -91,21 +95,26 @@ while condition {
> while 语句语法
>
>
###### while-statement {#while-statement}
#### while-statement {#while-statement}
> *while 语句* → **while** [*条件子句*](#condition-clause) [*代码块*](./05_Declarations.md#code-block)
>
###### condition-clause {#condition-clause}
#### condition-clause {#condition-clause}
> *条件子句* → [*表达式*](./04_Expressions.md#expression) | [*表达式*](./04_Expressions.md#expression) **,** [*条件列表*](#condition-list)
>
###### condition {#condition}
#### condition {#condition}
> *条件* → [*表达式*](./04_Expressions.md#expression) |[*可用性条件*](#availability-condition) | [*case 条件*](#case-condition) | [*可选绑定条件*](#optional-binding-condition)
>
>
###### case-condition {#case-condition}
#### case-condition {#case-condition}
> *case 条件* → **case** [*模式*](./08_Patterns.md#pattern) [*构造器*](./06_Declarations.md#initializer)
>
###### optional-binding-condition {#optional-binding-condition}
#### optional-binding-condition {#optional-binding-condition}
> *可选绑定条件* → **let** [*模式*](./08_Patterns.md#pattern) [*构造器*](./06_Declarations.md#initializer) | **var** [*模式*](./08_Patterns.md#pattern) [*构造器*](./06_Declarations.md#initializer)
>
@ -132,7 +141,8 @@ repeat {
> repeat-while 语句语法
>
>
###### repeat-while-statement {#repeat-while-statement}
#### repeat-while-statement {#repeat-while-statement}
> *repeat-while 语句* → **repeat** [*代码块*](./06_Declarations.md#code-block) **while** [*表达式*](./04_Expressions.md#expression)
>
@ -144,7 +154,8 @@ repeat {
> 分支语句语法
>
>
###### branch-statement {#branch-statement}
#### branch-statement {#branch-statement}
> *分支语句* → [*if 语句*](#if-statement)
>
> *分支语句* → [*guard 语句*](#guard-statement)
@ -192,10 +203,12 @@ if condition 1 {
> if 语句语法
>
>
###### if-statement {#if-statement}
#### if-statement {#if-statement}
> *if 语句* → **if** [*条件子句*](#condition-clause) [*代码块*](05_Declarations.md#code-block) [*else 子句*](#else-clause)<sub>可选</sub>
>
###### else-clause {#else-clause}
#### else-clause {#else-clause}
> *else 子句* → **else** [*代码块*](./06_Declarations.md#code-block) | **else** [*if 语句*](#if-statement)
>
@ -226,7 +239,8 @@ guard condition else {
> guard 语句语法
>
>
###### guard-statement {#guard-statement}
#### guard-statement {#guard-statement}
> *guard 语句* → **guard** [*条件子句*](#condition-clause) **else** [*代码块*] (05_Declarations.md#code-block)
>
@ -298,46 +312,59 @@ case .suppressed:
> switch 语句语法
>
>
###### switch-statement {#switch-statement}
#### switch-statement {#switch-statement}
> *switch 语句* → **switch** [*表达式*](./04_Expressions.md#expression) **{** [*switch-case 列表*](#switch-cases)<sub>可选</sub> **}**
>
###### switch-cases {#switch-cases}
#### switch-cases {#switch-cases}
> *switch case 列表* → [*switch-case*](#switch-case) [*switch-case 列表*](#switch-cases)<sub>可选</sub>
>
###### switch-case {#switch-case}
#### switch-case {#switch-case}
> *switch case* → [*case 标签*](#case-label) [*多条语句*](#statements) | [*default 标签*](#default-label) [*多条语句*](#statements) | [*conditional-switch-case*](#conditional-switch-case-label)
>
###### case-label {#case-label}
#### case-label {#case-label}
> *case 标签* → [*属性*](#switch-case-attributes-label)<sub>可选</sub> **case** [*case 项列表*](#case-item-list) **:**
>
###### case-item-list {#case-item-list}
#### case-item-list {#case-item-list}
> *case 项列表* → [*模式*](./08_Patterns.md#pattern) [*where 子句*](#where-clause)<sub>可选</sub> | [*模式*](07_Patterns.md#pattern) [*where 子句*](#where-clause)<sub>可选</sub> **,** [*case 项列表*](#case-item-list)
>
###### default-label {#default-label}
#### default-label {#default-label}
> *default 标签* → [*属性*](#switch-case-attributes-label)<sub>可选</sub> **default** **:**
>
>
###### where-clause {#where-clause}
#### where-clause {#where-clause}
> *where-clause* → **where** [*where 表达式*](#where-expression)
>
###### where-expression {#where-expression}
#### where-expression {#where-expression}
> *where-expression* → [*表达式*](./04_Expressions.md#expression)
>
>
###### grammar_conditional-switch-case {#grammar_conditional-switch-case}
#### grammar_conditional-switch-case {#grammar_conditional-switch-case}
> *conditional-switch-case* → [*switch-if-directive-clause*](#switch-case-attributes-label) [*switch-elseif-directive-clauses*](#switch-case-attributes-label) <sub>可选</sub> [*switch-else-directive-clause*](#switch-case-attributes-label) <sub>可选</sub> [*endif-directive*](#switch-case-attributes-label)
>
###### grammar_switch-if-directive-clause {#grammar_switch-if-directive-clause}
#### grammar_switch-if-directive-clause {#grammar_switch-if-directive-clause}
> *switch-if-directive 语句* → [*if-directive*](#switch-case-attributes-label) [*compilation-condition*](#switch-case-attributes-label) [*switch-cases*](#switch-case-attributes-label) <sub>可选</sub>
>
###### grammar_switch-elseif-directive-clauses {#grammar_switch-elseif-directive-clauses}
#### grammar_switch-elseif-directive-clauses {#grammar_switch-elseif-directive-clauses}
> *switch-elseif-directive 语句（复数）* → [*elseif-directive-clause*](#switch-case-attributes-label) [*switch-elseif-directive-clauses*](#switch-case-attributes-label)<sub>可选</sub>
>
###### grammar_switch-elseif-directive-clause {#grammar_switch-elseif-directive-clause}
#### grammar_switch-elseif-directive-clause {#grammar_switch-elseif-directive-clause}
> *switch-elseif-directive 语句* → [*elseif-directive*](#switch-case-attributes-label) [*compilation-condition*](#switch-case-attributes-label) [*switch-cases*](#switch-case-attributes-label)<sub>可选</sub>
>
###### grammar_switch-else-directive-clause {#grammar_switch-else-directive-clause}
#### grammar_switch-else-directive-clause {#grammar_switch-else-directive-clause}
> *switch-else-directive 语句* → [*else-directive*](#switch-case-attributes-label) [*switch-cases*](#switch-case-attributes-label) <sub>可选</sub>
>
@ -351,7 +378,8 @@ case .suppressed:
> 带标签的语句语法
>
>
###### labeled-statement {#labeled-statement}
#### labeled-statement {#labeled-statement}
> *带标签的语句* → [*语句标签*](#statement-label) [*循环语句*](#grammar_loop-statement)
>
> *带标签的语句* → [*语句标签*](#statement-label) [*if 语句*](#if-statement)
@ -360,10 +388,12 @@ case .suppressed:
>
> > *带标签的语句* → [*语句标签*](#statement-label) [*do 语句*](#sdo-statement)
>
###### statement-label {#statement-label}
#### statement-label {#statement-label}
> *语句标签* → [*标签名称*](#label-name) **:**
>
###### label-name {#label-name}
#### label-name {#label-name}
> *标签名称* → [*标识符*](./02_Lexical_Structure.md#identifier)
>
@ -373,7 +403,8 @@ case .suppressed:
> 控制转移语句语法
>
>
###### control-transfer-statement {#control-transfer-statement}
#### control-transfer-statement {#control-transfer-statement}
> *控制转移语句* → [*break 语句*](#break-statement)
>
> *控制转移语句* → [*continue 语句*](#continue-statement)
@ -404,7 +435,8 @@ case .suppressed:
> break 语句语法
>
>
###### break-statement {#break-statement}
#### break-statement {#break-statement}
> *break 语句* → **break** [*标签名称*](#label-name)<sub>可选</sub>
>
@ -429,7 +461,8 @@ case .suppressed:
> continue 语句语法
>
>
###### continue-statement {#continue-statement}
#### continue-statement {#continue-statement}
> *continue 语句* → **continue** [*标签名称*](#label-name)<sub>可选</sub>
>
@ -443,7 +476,8 @@ case .suppressed:
> fallthrough 语句语法
>
>
###### fallthrough-statement {#fallthrough-statement}
#### fallthrough-statement {#fallthrough-statement}
> *fallthrough 语句* → **fallthrough**
>
@ -470,7 +504,8 @@ case .suppressed:
> return 语句语法
>
>
###### return-statement {#return-statement}
#### return-statement {#return-statement}
> *return 语句* → **return** [*表达式*](./04_Expressions.html#expression)<sub>可选</sub>
### Throw 语句 {#throw_statements}
@ -492,7 +527,8 @@ case .suppressed:
> throw 语句语法
>
>
###### throw-statement {#throw-statement}
#### throw-statement {#throw-statement}
> *throw 语句* → **throw** [*表达式*](./04_Expressions.md#expression)
>
@ -528,7 +564,8 @@ f()
> defer 语句语法
>
>
###### defer-statement {#defer-statement}
#### defer-statement {#defer-statement}
> *延迟语句* → **defer** [*代码块*](./06_Declarations.md#code-block)
>
@ -559,13 +596,16 @@ do {
> do 语句语法
>
>
###### do-statement {#do-statement}
#### do-statement {#do-statement}
> *do 语句* → **do** [*代码块*](./06_Declarations.md#code-block) [*多条 catch 子句*](#catch-clauses)<sub>可选</sub>
>
###### catch-clauses {#catch-clauses}
#### catch-clauses {#catch-clauses}
> *多条 catch 子句* → [*catch 子句*](#catch-clause) [*多条 catch 子句*](#catch-clauses)<sub>可选</sub>
>
###### catch-clause {#catch-clause}
#### catch-clause {#catch-clause}
> *catch 子句* → **catch** [*模式*](./08_Patterns.md#pattern)<sub>可选</sub> [*where 子句*](#where-clause)<sub>可选</sub> [*代码块*](05_Declarations.md#code-block)
>
@ -575,7 +615,8 @@ do {
> 编译器控制语句语法
>
>
###### compiler-control-statement {#compiler-control-statement}
#### compiler-control-statement {#compiler-control-statement}
> *编译器控制语句* → [*条件编译语句*](#grammar_conditional-compilation-block)
>
> *编译器控制语句* → [*线路控制语句*](#line-control-statement)
@ -654,23 +695,29 @@ statements to compile if both compilation conditions are false
> 即使没有被编译，编译配置中的语句仍然会被解析。然而，唯一的例外是编译配置语句中包含语言版本检测函数：仅当 `Swift` 编译器版本和语言版本检测函数中指定的版本号匹配时，语句才会被解析。这种设定能确保旧的编译器不会尝试去解析新 Swift 版本的语法。
>
###### build-config-statement {#build-config-statement}
#### build-config-statement {#build-config-statement}
> 条件编译代码块语法
>
>
###### grammar_conditional-compilation-block {#grammar_conditional-compilation-block}
#### grammar_conditional-compilation-block {#grammar_conditional-compilation-block}
> *条件编译代码块* → [*if-directive 语句*](#grammar_if-directive-clause) [*elseif-directive 语句（复数）*](#grammar_elseif-directive-clauses)<sub>可选</sub> [*else-directive 语句*](#grammar_else-directive-clause)<sub>可选</sub> [*endif-directive*](#grammar_endif-directive)
>
###### grammar_if-directive-clause {#grammar_if-directive-clause}
#### grammar_if-directive-clause {#grammar_if-directive-clause}
> *if-directive 语句* → [*if-directive*](#grammar_if-directive) [*编译条件*](#compilation-condition) [*语句（复数）*](#statements)<sub>可选</sub>
>
###### grammar_elseif-directive-clauses {#grammar_elseif-directive-clauses}
#### grammar_elseif-directive-clauses {#grammar_elseif-directive-clauses}
> *elseif-directive 语句（复数）* → [*elseif-directive 语句*](#grammar_elseif-directive-clause) [*elseif-directive 语句（复数）*](#grammar_elseif-directive-clauses)
>
###### grammar_elseif-directive-clauses {#grammar_elseif-directive-clauses}
#### grammar_elseif-directive-clauses {#grammar_elseif-directive-clauses}
> *elseif-directive 语句* → [*elseif-directive*](#grammar_elseif-directive) [*编译条件*](#compilation-condition) [*语句（复数）*](#statements)<sub>可选</sub>
>
###### grammar_else-directive-clause {#grammar_else-directive-clause}
#### grammar_else-directive-clause {#grammar_else-directive-clause}
> *else-directive 语句* → [*else-directive*](#grammar_else-directive) [*语句（复数）*](#statements)<sub>可选</sub>
>
@ -684,7 +731,8 @@ statements to compile if both compilation conditions are false
> *endif-directive* → **#endif**
>
###### compilation-condition {#compilation-condition}
#### compilation-condition {#compilation-condition}
> *编译条件* → [*平台条件*](#grammar_platform-condition)
>
> *编译条件* → [*标识符*](./02_Lexical_Structure.md#identifier)
@ -700,41 +748,54 @@ statements to compile if both compilation conditions are false
> *编译条件* → [*编译条件*](#compilation-condition) **||** [*编译条件*](#compilation-condition)
>
###### grammar_platform-condition {#grammar_platform-condition}
###### grammar_platform-condition-os {#grammar_platform-condition-os}
#### grammar_platform-condition {#grammar_platform-condition}
#### grammar_platform-condition-os {#grammar_platform-condition-os}
> *平台条件* → **os ( [*操作系统*](#operating-system) )**
>
###### grammar_platform-condition-arch {#grammar_platform-condition-arch}
#### grammar_platform-condition-arch {#grammar_platform-condition-arch}
> *平台条件* → **arch ( [*架构*](#architecture) )**
>
###### grammar_platform-condition-swift {#grammar_platform-condition-swift}
#### grammar_platform-condition-swift {#grammar_platform-condition-swift}
> *平台条件* → **swift ( >= [*swift 版本*](#swift-version) )** | **swift ( < [*swift 版本*](#swift-version) )**
>
###### grammar_platform-condition-compiler {#grammar_platform-condition-compiler}
#### grammar_platform-condition-compiler {#grammar_platform-condition-compiler}
> *平台条件* → **compiler ( >= [*swift 版本*](#swift-version) )** | **compiler ( < [*swift 版本*](#swift-version) )**
>
###### grammar_platform-condition-canImport {#grammar_platform-condition-canImport}
#### grammar_platform-condition-canImport {#grammar_platform-condition-canImport}
> *平台条件* → **canImport ( [*模块名*](#grammar_module-name) )**
>
###### grammar_platform-condition-targetEnvironment {#grammar_platform-condition-targetEnvironment}
#### grammar_platform-condition-targetEnvironment {#grammar_platform-condition-targetEnvironment}
> *平台条件* → **targetEnvironment ( [*环境*](#grammar_environment) )**
>
###### operating-system {#operating-system}
#### operating-system {#operating-system}
> *操作系统* → **macOS** | **iOS** | **watchOS** | **tvOS**
>
###### architecture {#architecture}
#### architecture {#architecture}
> *架构* → **i386** | **x86_64** | **arm** | **arm64**
>
###### swift-version {#swift-version}
#### swift-version {#swift-version}
> *swift 版本* → [*十进制数字*](./02_Lexical_Structure.md#decimal-digit) ­**.** ­[*swift 版本延续*](#grammar_swift-version-continuation) <sub>可选</sub>
>
###### grammar_swift-version-continuation {#grammar_swift-version-continuation}
#### grammar_swift-version-continuation {#grammar_swift-version-continuation}
> *swift 版本延续* → **.** [*十进制数字*](./02_Lexical_Structure.md#decimal-digit) [*swift 版本延续*](#grammar_swift-version-continuation) <sub>可选</sub>
>
###### grammar_module-name {#grammar_module-name}
#### grammar_module-name {#grammar_module-name}
> *模块名* → [*identifier*](./02_Lexical_Structure.md#identifier)
>
###### grammar_environment {#grammar_environment}
#### grammar_environment {#grammar_environment}
> *环境* → **模拟器**
>
@ -753,7 +814,8 @@ statements to compile if both compilation conditions are false
第二种的行控制语句，`#sourceLocation()`，会将源代码的定位信息重置回默认的行号和文件名。
###### line-control-statement {#line-control-statement}
#### line-control-statement {#line-control-statement}
> 行控制语句语法
>
>
@ -761,10 +823,12 @@ statements to compile if both compilation conditions are false
>
> *行控制语句* → **#sourceLocation()**
>
###### line-number {#line-number}
#### line-number {#line-number}
> *行号* → 大于 0 的十进制整数
>
###### file-name {#file-name}
#### file-name {#file-name}
> *文件名* → [*静态字符串字面量*](./02_Lexical_Structure.md#static-string-literal)
>
@ -782,12 +846,14 @@ statements to compile if both compilation conditions are false
> 编译时诊断语句语法
>
>
###### grammar_compile-time-diagnostic-statement {#grammar_compile-time-diagnostic-statement}
#### grammar_compile-time-diagnostic-statement {#grammar_compile-time-diagnostic-statement}
> *诊断语句* → **#error** **(** [*diagnostic-message*](#grammar_diagnostic-message) **)**
>
> *诊断语句* → **#warning** **(** [*diagnostic-message*](#grammar_diagnostic-message) **)**
>
###### grammar_diagnostic-message {#grammar_diagnostic-message}
#### grammar_diagnostic-message {#grammar_diagnostic-message}
> *诊断语句* → [*静态字符串字面量*](./02_Lexical_Structure.md#static-string-literal)
>
@ -813,19 +879,23 @@ if #available(platform name version, ..., *) {
> 可用性条件语法
>
>
###### availability-condition {#availability-condition}
#### availability-condition {#availability-condition}
> *可用性条件* → **#available** **(** [*可用性参数列表*](#availability-arguments) **)**
>
###### availability-arguments {#availability-arguments}
#### availability-arguments {#availability-arguments}
> *可用性参数列表* → [*可用性参数*](#availability-argument) | [*可用性参数*](#availability-argument) **,** [*可用性参数列表*](#availability-arguments)
>
###### availability-argument {#availability-argument}
#### availability-argument {#availability-argument}
> *可用性参数* → [平台名称](#platform-name) [平台版本](#platform-version)
>
> *可用性条件* → __*__
>
>
###### platform-name {#platform-name}
#### platform-name {#platform-name}
> *平台名称* → **iOS** | **iOSApplicationExtension**
>
> *平台名称* → **OSX** | **macOSApplicationExtension**
@ -834,7 +904,8 @@ if #available(platform name version, ..., *) {
>
> *平台名称* → **tvOS**
>
###### platform-version {#platform-version}
#### platform-version {#platform-version}
> *平台版本* → [十进制数字](./02_Lexical_Structure.md#decimal-digits)
>
> *平台版本* → [十进制数字](./02_Lexical_Structure.md#decimal-digits) **.** [十进制数字](./02_Lexical_Structure.md#decimal-digits)

360
source/chapter3/06_Declarations.md
View File

@ -5,7 +5,8 @@
> 声明语法
>
> ###### declaration {#declaration}
>
#### declaration {#declaration}
>
> *声明* → [*导入声明*](#import-declaration)
>
@ -35,7 +36,8 @@
>
> *声明* → [*运算符声明*](#operator-declaration)
>
> ###### declarations {#declarations}
>
#### declarations {#declarations}
>
> *多条声明* → [*声明*](#declaration) [*多条声明*](#declarations)<sub>可选</sub>
>
@ -61,7 +63,8 @@ Swift 的源文件中的顶级代码（top-level code）由零个或多个语句
> 代码块语法
>
> ###### code-block {#code-block}
>
#### code-block {#code-block}
>
> *代码块* → **{** [*多条语句*](./05_Statements.md#statements)<sub>可选</sub> **}**
>
@ -80,22 +83,27 @@ import 导入类型 模块.符号名
import 模块.子模块
```
###### grammer_of_an_import_declaration {#grammer_of_an_import_declaration}
#### grammer_of_an_import_declaration {#grammer_of_an_import_declaration}
> 导入声明语法
>
> ###### import-declaration {#import-declaration}
>
#### import-declaration {#import-declaration}
>
> *导入声明* → [*特性列表*](./07_Attributes.md#attributes)<sub>可选</sub> **import** [*导入类型*](#import-kind)<sub>可选</sub> [*导入路径*](#import-path)
>
> ###### import-kind {#import-kind}
>
#### import-kind {#import-kind}
>
> *导入类型* → **typealias** | **struct** | **class** | **enum** | **protocol** | **let** | **var** | **func**
>
> ###### import-path {#import-path}
>
#### import-path {#import-path}
>
> *导入路径* → [*导入路径标识符*](#import-path-identifier) | [*导入路径标识符*](#import-path-identifier) **.** [*导入路径*](#import-path)
>
> ###### import-path-identifier {#import-path-identifier}
>
#### import-path-identifier {#import-path-identifier}
>
> *导入路径标识符* → [*标识符*](./02_Lexical_Structure.md#identifier) | [*运算符*](./02_Lexical_Structure.md#operator)
>
@ -132,22 +140,27 @@ print("The second number is \(secondNumber).")
如果还想获得更多关于常量的信息或者想在使用中获得帮助，请参阅 [常量和变量](../chapter2/01_The_Basics.md#constants_and_variables) 和 [存储属性](../chapter2/10_Properties.md#stored_properties)。
###### grammer_of_a_constant_declaration {#grammer_of_a_constant_declaration}
#### grammer_of_a_constant_declaration {#grammer_of_a_constant_declaration}
> 常量声明语法
>
> ###### constant-declaration {#constant-declaration}
>
#### constant-declaration {#constant-declaration}
>
> *常量声明* → [*特性列表*](./07_Attributes.md#attributes)<sub>可选</sub> [*声明修饰符列表*](#declaration-modifiers)<sub>可选</sub> **let** [*模式构造器列表*](pattern-initializer-list)
>
> ###### pattern-initializer-list {#pattern-initializer-list}
>
#### pattern-initializer-list {#pattern-initializer-list}
>
> *模式构造器列表* → [*模式构造器*](#pattern-initializer) | [*模式构造器*](#pattern-initializer) **,** [*模式构造器列表*](#pattern-initializer-list)
>
> ###### pattern-initializer {#pattern-initializer}
>
#### pattern-initializer {#pattern-initializer}
>
> *模式构造器* → [*模式*](./08_Patterns.md#pattern) [*构造器*](#initializer)<sub>可选</sub>
>
> ###### initializer {#initializer}
>
#### initializer {#initializer}
>
> *构造器* → **=** [*表达式*](./04_Expressions.md#expression)
>
@ -242,10 +255,12 @@ var 变量名称: 类型 = 表达式 {
> 在一个类声明中，使用关键字 `static` 与同时使用 `class` 和 `final` 去标记一个声明的效果相同。
>
###### grammer_of_a_variable_declaration {#grammer_of_a_variable_declaration}
#### grammer_of_a_variable_declaration {#grammer_of_a_variable_declaration}
> 变量声明语法
>
###### variable-declaration {#variable-declaration}
#### variable-declaration {#variable-declaration}
> *变量声明* → [*变量声明头*](#variable-declaration-head) [*模式构造器列表*](#pattern-initializer-list)
>
> *变量声明* → [*变量声明头*](#variable-declaration-head) [*变量名称*](#variable-name) [*类型标注*](03_Types.md#type-annotation) [*代码块*](#code-block)
@ -259,58 +274,70 @@ var 变量名称: 类型 = 表达式 {
> *变量声明* → [*变量声明头*](#variable-declaration-head) [*变量名称*](#variable-name) [*类型标注*](03_Types.md#type-annotation) [*构造器*](#initializer)<sub>可选</sub> [*willSet-didSet 代码块*](#willSet-didSet-block)
>
###### variable-declaration-head {#variable-declaration-head}
#### variable-declaration-head {#variable-declaration-head}
> *变量声明头* → [*特性列表*](./07_Attributes.md#attributes)<sub>可选</sub> [*声明修饰符列表*](#declaration-modifiers)<sub>可选</sub> **var**
>
> ###### variable-name {#variable-name}
>
#### variable-name {#variable-name}
>
> *变量名称* → [*标识符*](./02_Lexical_Structure.md#identifier)
>
###### getter-setter-block {#getter-setter-block}
#### getter-setter-block {#getter-setter-block}
> *getter-setter 代码块* → [*代码块*](#code-block)
>
> *getter-setter 代码块* → **{** [*getter 子句*](#getter-clause) [*setter 子句*](#setter-clause)<sub>可选</sub> **}**
>
> *getter-setter 代码块* → **{** [*setter 子句*](#setter-clause) [*getter 子句*](#getter-clause) **}**
>
> ###### getter-clause {#getter-clause}
>
#### getter-clause {#getter-clause}
>
> *getter 子句* → [*特性列表*](./07_Attributes.md#attributes)<sub>可选</sub> **get** [*代码块*](#code-block)
>
> ###### setter-clause {#setter-clause}
>
#### setter-clause {#setter-clause}
>
> *setter 子句* → [*特性列表*](./07_Attributes.md#attributes)<sub>可选</sub> **set** [*setter 名称*](#setter-name)<sub>可选</sub> [*代码块*](#code-block)
>
> ###### setter-name {#setter-name}
>
#### setter-name {#setter-name}
>
> *setter 名称* → **(** [*标识符*](./02_Lexical_Structure.md#identifier) **)**
>
###### getter-setter-keyword-block {#getter-setter-keyword-block}
#### getter-setter-keyword-block {#getter-setter-keyword-block}
> *getter-setter 关键字代码块* → **{** [*getter 关键字子句*](#getter-keyword-clause) [*setter 关键字子句*](#setter-keyword-clause)<sub>可选</sub> **}**
>
> *getter-setter 关键字代码块* → **{** [*setter 关键字子句*](#setter-keyword-clause) [*getter 关键字子句*](#getter-keyword-clause) **}**
>
> ###### getter-keyword-clause {#getter-keyword-clause}
>
#### getter-keyword-clause {#getter-keyword-clause}
>
> *getter 关键字子句* → [*特性列表*](./07_Attributes.md#attributes)<sub>可选</sub> **get**
>
> ###### setter-keyword-clause {#setter-keyword-clause}
>
#### setter-keyword-clause {#setter-keyword-clause}
>
> *setter 关键字子句* → [*特性列表*](./07_Attributes.md#attributes)<sub>可选</sub> **set**
>
###### willSet-didSet-block {#willSet-didSet-block}
#### willSet-didSet-block {#willSet-didSet-block}
> *willSet-didSet 代码块* → **{** [*willSet 子句*](#willSet-clause) [*didSet 子句*](#didSet-clause)<sub>可选</sub> **}**
>
> *willSet-didSet 代码块* → **{** [*didSet 子句*](#didSet-clause) [*willSet 子句*](#willSet-clause)<sub>可选</sub> **}**
>
> ###### willSet-clause {#willSet-clause}
>
#### willSet-clause {#willSet-clause}
>
> *willSet 子句* → [*特性列表*](./07_Attributes.md#attributes)<sub>可选</sub> **willSet** [*setter 名称*](#setter-name)<sub>可选</sub> [*代码块*](#code-block)
>
> ###### didSet-clause {#didSet-clause}
>
#### didSet-clause {#didSet-clause}
>
> *didSet 子句* → [*特性列表*](./07_Attributes.md#attributes)<sub>可选</sub> **didSet** [*setter 名称*](#setter-name)<sub>可选</sub> [*代码块*](#code-block)
>
@ -370,19 +397,23 @@ func sum<T: Sequence>(_ sequence: T) -> Int where T.Element == Int {
另请参阅 [协议关联类型声明](#protocol_associated_type_declaration)。
###### grammer_of_a_type_alias_declaration {#grammer_of_a_type_alias_declaration}
#### grammer_of_a_type_alias_declaration {#grammer_of_a_type_alias_declaration}
> 类型别名声明语法
>
>
> ###### typealias-declaration {#typealias-declaration}
>
#### typealias-declaration {#typealias-declaration}
>
> *类型别名声明* → [*特性列表*](./07_Attributes.md#attributes)<sub>可选</sub> [*访问级别修饰符*](#access-level-modifier)<sub>可选</sub> **typealias** [*类型别名名称*](#typealias-name) [*类型别子句*](#typealias-clause) [*类型别名赋值*](#typealias-assignment)
>
> ###### typealias-name {#typealias-name}
>
#### typealias-name {#typealias-name}
>
> *类型别名名称* → [*标识符*](./02_Lexical_Structure.md#identifier)
>
> ###### typealias-assignment {#typealias-assignment}
>
#### typealias-assignment {#typealias-assignment}
>
> *类型别名赋值* → **=** [*类型*](./03_Types.md#type)
>
@ -570,46 +601,56 @@ Swift 定义了 `Never` 类型，它表示函数或者方法不会返回给它
你可以重写一个不归方法，但是新的方法必须保持原有的返回类型和没有返回的行为。
###### grammer_of_a_function_declaration {#grammer_of_a_function_declaration}
#### grammer_of_a_function_declaration {#grammer_of_a_function_declaration}
> 函数声明语法
>
###### function-declaration {#function-declaration}
#### function-declaration {#function-declaration}
> *函数声明* → [*函数头*](#function-head) [*函数名*](#function-name) [*泛型形参子句*](08_Generic_Parameters_and_Arguments.md#generic-parameter-clause)<sub>可选</sub> [*函数签名*](#function-signature) [*泛型 where 子句*](08_Generic_Parameters_and_Arguments.md#generic-where-clause) [*函数体*](#function-body)<sub>可选</sub>
>
###### function-head {#function-head}
#### function-head {#function-head}
> *函数头* → [*特性列表*](./07_Attributes.md#attributes)<sub>可选</sub> [*声明修饰符列表*](#declaration-modifiers)<sub>可选</sub> **func**
>
> ###### function-name {#function-name}
>
#### function-name {#function-name}
>
> *函数名* → [*标识符*](./02_Lexical_Structure.md#identifier) | [*运算符*](./02_Lexical_Structure.md#operator)
>
>
> ###### function-signature {#function-signature}
>
#### function-signature {#function-signature}
>
>
> *函数签名* → [*参数子句列表*](#parameter-clauses) **throws**<sub>可选</sub> [*函数结果*](#function-result)<sub>可选</sub>
>
> *函数签名* → [*参数子句列表*](#parameter-clauses) **rethrows** [*函数结果*](#function-result)<sub>可选</sub>
>
> ###### function-result {#function-result}
>
#### function-result {#function-result}
>
> *函数结果* → **->** [*特性列表*](./07_Attributes.md#attributes)<sub>可选</sub> [*类型*](./03_Types.md#type)
>
> ###### function-body {#function-body}
>
#### function-body {#function-body}
>
> *函数体* → [*代码块*](#code-block)
>
> ###### parameter-clause {#parameter-clause}
>
#### parameter-clause {#parameter-clause}
>
> *参数子句* → **(** **)** | **(** [*参数列表*](#parameter-list) **)**
>
> ###### parameter-list {#parameter-list}
>
#### parameter-list {#parameter-list}
>
> *参数列表* → [*参数*](#parameter) | [*参数*](#parameter) **,** [*参数列表*](#parameter-list)
>
> ###### parameter {#parameter}
>
#### parameter {#parameter}
>
> *参数* → [*外部参数名*](#external-parameter-name)<sub>可选</sub> [*内部参数名*](#local-parameter-name) [*类型标注*](03_Types.md#type-annotation) [*默认参数子句*](#default-argument-clause)<sub>可选</sub>
>
@ -617,15 +658,18 @@ Swift 定义了 `Never` 类型，它表示函数或者方法不会返回给它
>
> *参数* → [*外部参数名*](#external-parameter-name)<sub>可选</sub> [*内部参数名*](#local-parameter-name) [*类型标注*](03_Types.md#type-annotation) **...**
>
> ###### external-parameter-name {#external-parameter-name}
>
#### external-parameter-name {#external-parameter-name}
>
> *外部参数名* → [*标识符*](./02_Lexical_Structure.md#identifier) | **_**
>
> ###### local-parameter-name {#local-parameter-name}
>
#### local-parameter-name {#local-parameter-name}
>
> *内部参数名* → [*标识符*](./02_Lexical_Structure.md#identifier) | **_**
>
> ###### default-argument-clause {#default-argument-clause}
>
#### default-argument-clause {#default-argument-clause}
>
> *默认参数子句* → **=** [*表达式*](./04_Expressions.md#expression)
>
@ -731,11 +775,13 @@ enum GamePlayMode: String {
可以使用 `switch` 语句来检验枚举用例的值，正如 [使用 switch 语句匹配枚举值](../chapter2/08_Enumerations.md#matching_enumeration_values_with_a_switch_statement) 所述。枚举类型是模式匹配的，依靠 `switch` 语句 `case` 块中的枚举用例模式，正如 [枚举用例模式](./08_Patterns.md#enumeration_case_pattern) 所述。
###### grammer_of_an_enumeration_declaration {#grammer_of_an_enumeration_declaration}
#### grammer_of_an_enumeration_declaration {#grammer_of_an_enumeration_declaration}
> 枚举声明语法
>
>
> ###### enum-declaration {#enum-declaration}
>
#### enum-declaration {#enum-declaration}
>
> *枚举声明* → [*特性列表*](./07_Attributes.md#attributes)<sub>可选</sub> [*访问级别修饰符*](#access-level-modifier)<sub>可选</sub> [*联合风格枚举*](#union-style-enum)
>
@ -744,31 +790,38 @@ enum GamePlayMode: String {
>
> *联合风格枚举* → **indirect**<sub>可选</sub> **enum** [*枚举名称*](#enum-name) [*泛型形参子句*](08_Generic_Parameters_and_Arguments.md#generic-parameter-clause)<sub>可选</sub> [类型继承子句](./03_Types.md#type-inheritance-clause)<sub>可选</sub> **{** [*多个联合风格枚举成员*](#union-style-enum-members)<sub>可选</sub> **}**
>
> ###### union-style-enum-members {#union-style-enum-members}
>
#### union-style-enum-members {#union-style-enum-members}
>
> *多个联合风格枚举成员* → [*联合风格枚举成员*](#union-style-enum-member) [*多个联合风格枚举成员*](#union-style-enum-members)<sub>可选</sub>
>
> ###### union-style-enum-member {#union-style-enum-member}
>
#### union-style-enum-member {#union-style-enum-member}
>
> *联合风格枚举成员* → [*声明*](#declaration) | [*联合风格枚举用例子句*](#union-style-enum-case-clause) | [*编译控制流语句*](05_Statements.md#compiler-control-statement)
>
> ###### union-style-enum-case-clause {#union-style-enum-case-clause}
>
#### union-style-enum-case-clause {#union-style-enum-case-clause}
>
> *联合风格枚举用例子句* → [*特性列表*](./07_Attributes.md#attributes)<sub>可选</sub> **indirect**<sub>可选</sub> **case** [*联合风格枚举用例列表*](#union-style-enum-case-list)
>
> ###### union-style-enum-case-list {#union-style-enum-case-list}
>
#### union-style-enum-case-list {#union-style-enum-case-list}
>
> *联合风格枚举用例列表* → [*联合风格枚举用例*](#union-style-enum-case) | [*联合风格枚举用例*](#union-style-enum-case) **,** [*联合风格枚举用例列表*](#union-style-enum-case-list)
>
> ###### union-style-enum-case {#union-style-enum-case}
>
#### union-style-enum-case {#union-style-enum-case}
>
> *联合风格枚举用例* → [*枚举用例名称*](#enum-case-name) [*元组类型*](03_Types.md#tuple-type)<sub>可选</sub>
>
> ###### enum-name {#enum-name}
>
#### enum-name {#enum-name}
>
> *枚举名称* → [*标识符*](./02_Lexical_Structure.md#identifier)
>
> ###### enum-case-name {#enum-case-name}
>
#### enum-case-name {#enum-case-name}
>
> *枚举用例名称* → [*标识符*](./02_Lexical_Structure.md#identifier)
>
@ -778,31 +831,38 @@ enum GamePlayMode: String {
>
> *原始值风格枚举* → **enum** [*枚举名称*](#enum-name) [*泛型形参子句*](08_Generic_Parameters_and_Arguments.md#generic-parameter-clause)<sub>可选</sub> [*类型继承子句*](./03_Types.md#type-inheritance-clause) [*泛型 where 子句*](./09_Generic_Parameters_and_Arguments.md#generic-where-clause) **{** [*多个原始值风格枚举成员*](#raw-value-style-enum-members) **}**
>
> ###### raw-value-style-enum-members {#raw-value-style-enum-members}
>
#### raw-value-style-enum-members {#raw-value-style-enum-members}
>
> *多个原始值风格枚举成员* → [*原始值风格枚举成员*](#raw-value-style-enum-member) [*多个原始值风格枚举成员*](#raw-value-style-enum-members)<sub>可选</sub>
>
> ###### raw-value-style-enum-member {#raw-value-style-enum-member}
>
#### raw-value-style-enum-member {#raw-value-style-enum-member}
>
> *原始值风格枚举成员* → [*声明*](#declaration) | [*原始值风格枚举用例子句*](#raw-value-style-enum-case-clause) | [*编译控制流语句*](05_Statements.md#compiler-control-statement)
>
> ###### raw-value-style-enum-case-clause {#raw-value-style-enum-case-clause}
>
#### raw-value-style-enum-case-clause {#raw-value-style-enum-case-clause}
>
> *原始值风格枚举用例子句* → [*特性列表*](./07_Attributes.md#attributes)<sub>可选</sub> **case** [*原始值风格枚举用例列表*](#raw-value-style-enum-case-list)
>
> ###### raw-value-style-enum-case-list {#raw-value-style-enum-case-list}
>
#### raw-value-style-enum-case-list {#raw-value-style-enum-case-list}
>
> *原始值风格枚举用例列表* → [*原始值风格枚举用例*](#raw-value-style-enum-case) | [*原始值风格枚举用例*](#raw-value-style-enum-case) **,** [*原始值风格枚举用例列表*](#raw-value-style-enum-case-list)
>
> ###### raw-value-style-enum-case {#raw-value-style-enum-case}
>
#### raw-value-style-enum-case {#raw-value-style-enum-case}
>
> *原始值风格枚举用例* → [*枚举用例名称*](#enum-case-name) [*原始值赋值*](#raw-value-assignment)<sub>可选</sub>
>
> ###### raw-value-assignment {#raw-value-assignment}
>
#### raw-value-assignment {#raw-value-assignment}
>
> *原始值赋值* → **=** [*原始值字面量*](#raw-value-literal)
>
> ###### raw-value-literal {#raw-value-literal}
>
#### raw-value-literal {#raw-value-literal}
>
> *原始值字面量* → [数字型字面量](./02_Lexical_Structure.md#numeric-literal) | [字符串型字面量](./02_Lexical_Structure.md#static-string-literal) | [布尔型字面量](./02_Lexical_Structure.md#boolean-literal)
>
@ -837,28 +897,34 @@ struct 结构体名称: 采纳的协议 {
可以使用扩展声明来扩展结构体类型的行为，请参阅 [扩展声明](#extension_declaration)。
###### grammer_of_a_structure_declaration {#grammer_of_a_structure_declaration}
#### grammer_of_a_structure_declaration {#grammer_of_a_structure_declaration}
> 结构体声明语法
>
>
> ###### struct-declaration {#struct-declaration}
>
#### struct-declaration {#struct-declaration}
>
> *结构体声明* → [*特性列表*](./07_Attributes.md#attributes)<sub>可选</sub> [*访问级别修饰符*](#access-level-modifier) <sub>可选</sub> **struct** [*结构体名称*](#struct-name) [*泛型形参子句*](08_Generic_Parameters_and_Arguments.md#generic-parameter-clause)<sub>可选</sub> [*类型继承子句*](./03_Types.md#type-inheritance-clause)<sub>可选</sub> [*泛型 where 子句*](./09_Generic_Parameters_and_Arguments.md#generic-where-clause)<sub>可选</sub> [*结构体主体*](#struct-body)
>
> ###### struct-name {#struct-name}
>
#### struct-name {#struct-name}
>
> *结构体名称* → [*标识符*](./02_Lexical_Structure.md#identifier)
>
> ###### struct-body {#struct-body}
>
#### struct-body {#struct-body}
>
> *结构体主体* → **{** [*多条声明*](#declarations)<sub>可选</sub> **}**
>
> ###### struct-name {#struct-name}
>
#### struct-name {#struct-name}
>
>
> *结构体多个成员* → [*结构体成员*](#struct-member) [*结构体多个成员*](#struct-members)<sub>可选</sub>
>
> ###### struct-member {#struct-member}
>
#### struct-member {#struct-member}
>
> *结构体成员* → [*声明*](#declaration) | [*编译控制流语句*](05_Statements.md#compiler-control-statement)
>
@ -896,28 +962,33 @@ class 类名: 超类, 采纳的协议 {
可以使用扩展声明来扩展类的行为，请参阅 [扩展声明](#extension_declaration)。
###### grammer_of_a_class_declaration {#grammer_of_a_class_declaration}
#### grammer_of_a_class_declaration {#grammer_of_a_class_declaration}
> 类声明语法
>
>
> ###### class-declaration {#class-declaration}
>
#### class-declaration {#class-declaration}
>
> *类声明* → [*特性列表*](./07_Attributes.md#attributes)<sub>可选</sub> [访问级别修饰符](#access-level-modifier)<sub>可选</sub> **final**<sub>可选</sub> **class** [*类名*](#class-name) [*泛型形参子句*](08_Generic_Parameters_and_Arguments.md#generic-parameter-clause)<sub>可选</sub> [*类型继承子句*](./03_Types.md#type-inheritance-clause)<sub>可选</sub> [*泛型 where 子句*](./09_Generic_Parameters_and_Arguments.md#generic-where-clause)<sub>可选</sub> [*类主体*](#class-body)
>
> *类声明* → [*特性列表*](./07_Attributes.md#attributes)<sub>可选</sub> **final** [访问级别修饰符](#access-level-modifier)<sub>可选</sub> **class** [*类名*](#class-name) [*泛型形参子句*](08_Generic_Parameters_and_Arguments.md#generic-parameter-clause)<sub>可选</sub> [*类型继承子句*](./03_Types.md#type-inheritance-clause)<sub>可选</sub> [*泛型 where 子句*](./09_Generic_Parameters_and_Arguments.md#generic-where-clause)<sub>可选</sub> [*类主体*](#class-body)
>
> ###### class-name {#class-name}
>
#### class-name {#class-name}
>
> *类名* → [*标识符*](./02_Lexical_Structure.md#identifier)
>
> ###### class-body {#class-body}
>
#### class-body {#class-body}
>
> *类主体* → **{** [*多条声明*](#declarations)<sub>可选</sub> **}**
>
>
> *类多个成员* → [*类成员*](#class-member) [*类多个成员*](#class-members)<sub>可选</sub>
>
> ###### class-member {#class-member}
>
#### class-member {#class-member}
>
> *类成员* → [*声明*](#declaration) | [*编译控制流语句*](05_Statements.md#compiler-control-statement)
>
@ -963,31 +1034,37 @@ protocol SomeProtocol: AnyObject {
可以使用协议来声明作为代理的类或者结构体应该实现的方法，正如 [委托（代理）模式](../chapter2/21_Protocols.md#delegation) 中所述。
###### grammer_of_a_protocol_declaration {#grammer_of_a_protocol_declaration}
#### grammer_of_a_protocol_declaration {#grammer_of_a_protocol_declaration}
> 协议声明语法
>
>
> ###### protocol-declaration {#protocol-declaration}
>
#### protocol-declaration {#protocol-declaration}
>
> *协议声明* → [*特性列表*](./07_Attributes.md#attributes)<sub>可选</sub> [*访问级别修饰符*](#access-level-modifier)<sub>可选</sub> **protocol** [*协议名称*](#protocol-name) [*类型继承子句*](03_Types.md#type-inheritance-clause)<sub>可选</sub> [*泛型 where 子句*](./09_Generic_Parameters_and_Arguments.md#generic-where-clause)<sub>可选</sub> [*协议主体*](#protocol-body)
>
> ###### protocol-name {#protocol-name}
>
#### protocol-name {#protocol-name}
>
> *协议名称* → [*标识符*](./02_Lexical_Structure.md#identifier)
>
> ###### protocol-body {#protocol-body}
>
#### protocol-body {#protocol-body}
>
> *协议主体* → **{** [*协议成员声明列表*](#protocol-member-declarations)<sub>可选</sub> **}**
>
>
> *协议多个成员* → [*协议成员*](#protocol-member) [*协议多个成员*](#protocol-members)<sub>可选</sub>
>
> ###### protocol-member {#protocol-member}
>
#### protocol-member {#protocol-member}
>
> *协议成员* → [*协议成员声明*](#protocol-member-declaration) | [*编译控制流语句*](05_Statements.md#compiler-control-statement)
>
>
> ###### protocol-member-declaration {#protocol-member-declaration}
>
#### protocol-member-declaration {#protocol-member-declaration}
>
> *协议成员声明* → [*协议属性声明*](#protocol-property-declaration)
>
@ -999,7 +1076,8 @@ protocol SomeProtocol: AnyObject {
>
> *协议成员声明* → [*协议关联类型声明*](#protocol-associated-type-declaration)
>
> ###### protocol-member-declarations {#protocol-member-declarations}
>
#### protocol-member-declarations {#protocol-member-declarations}
>
> *协议成员声明列表* → [*协议成员声明*](#protocol-member-declaration) [*协议成员声明列表*](#protocol-member-declarations)<sub>可选</sub>
>
@ -1017,10 +1095,12 @@ var 属性名: 类型 { get set }
另请参阅 [变量声明](#variable_declaration)。
###### grammer_of_an_import_declaration {#grammer_of_an_import_declaration}
#### grammer_of_an_import_declaration {#grammer_of_an_import_declaration}
> 协议属性声明语法
>
> ###### protocol-property-declaration {#protocol-property-declaration}
>
#### protocol-property-declaration {#protocol-property-declaration}
>
> *协议属性声明* → [*变量声明头*](#variable-declaration-head) [*变量名称*](#variable-name) [*类型标注*](03_Types.md#type-annotation) [*getter-setter 关键字代码块*](#getter-setter-keyword-block)
>
@ -1032,10 +1112,12 @@ var 属性名: 类型 { get set }
另请参阅 [函数声明](#function_declaration)。
###### grammer_of_a_protocol_declaration {#grammer_of_a_protocol_declaration}
#### grammer_of_a_protocol_declaration {#grammer_of_a_protocol_declaration}
> 协议方法声明语法
>
> ###### protocol-method-declaration {#protocol-method-declaration}
>
#### protocol-method-declaration {#protocol-method-declaration}
>
> *协议方法声明* → [*函数头*](#function-head) [*函数名*](#function-name) [*泛型形参子句*](08_Generic_Parameters_and_Arguments.md#generic-parameter-clause)<sub>可选</sub> [*函数签名*](#function-signature) [*泛型 where 子句*](08_Generic_Parameters_and_Arguments.md#generic-where-clause)<sub>可选</sub>
>
@ -1050,10 +1132,12 @@ var 属性名: 类型 { get set }
另请参阅 [构造器声明](#initializer_declaration)。
###### grammer_of_a_protocol_initializer_declaration {#grammer_of_a_protocol_initializer_declaration}
#### grammer_of_a_protocol_initializer_declaration {#grammer_of_a_protocol_initializer_declaration}
> 协议构造器声明语法
>
> ###### protocol-initializer-declaration {#protocol-initializer-declaration}
>
#### protocol-initializer-declaration {#protocol-initializer-declaration}
>
> *协议构造器声明* → [*构造器头*](#initializer-head) [*泛型形参子句*](08_Generic_Parameters_and_Arguments.md#generic-parameter-clause)<sub>可选</sub> [*参数子句*](#parameter-clause) **throws**<sub>可选</sub> [*泛型 where 子句*](08_Generic_Parameters_and_Arguments.md#generic-where-clause)<sub>可选</sub>
>
@ -1072,10 +1156,12 @@ subscript (参数列表) -> 返回类型 { get set }
另请参阅 [下标声明](#subscript_declaration)。
###### grammer_of_a_protocol_subscript_declaration {#grammer_of_a_protocol_subscript_declaration}
#### grammer_of_a_protocol_subscript_declaration {#grammer_of_a_protocol_subscript_declaration}
> 协议下标声明语法
>
> ###### protocol-subscript-declaration {#protocol-subscript-declaration}
>
#### protocol-subscript-declaration {#protocol-subscript-declaration}
>
> *协议下标声明* → [*下标头*](#subscript-head) [*下标结果*](#subscript-result) [*泛型 where 子句*](08_Generic_Parameters_and_Arguments.md#generic-where-clause)<sub>可选</sub> [*getter-setter 关键字代码块*](#getter-setter-keyword-block)
>
@ -1103,10 +1189,12 @@ protocol SubProtocolB: SomeProtocol where SomeType: Equatable { }
另请参阅 [类型别名声明](#type_alias_declaration)。
###### grammer_of_a_protocol_associated_type_declaration {#grammer_of_a_protocol_associated_type_declaration}
#### grammer_of_a_protocol_associated_type_declaration {#grammer_of_a_protocol_associated_type_declaration}
> 协议关联类型声明语法
>
> ###### protocol-associated-type-declaration {#protocol-associated-type-declaration}
>
#### protocol-associated-type-declaration {#protocol-associated-type-declaration}
>
> *协议关联类型声明* → [*特性列表*](./07_Attributes.md#attributes)<sub>可选</sub> [*访问级别修饰符*](#access-level-modifier)<sub>可选</sub> **associatedtype** [*类型别名头*](#typealias-head) [*类型继承子句*](03_Types.md#type-inheritance-clause)<sub>可选</sub> [*类型别名赋值*](#typealias-assignment)<sub>可选</sub> [*泛型 where 子句*](08_Generic_Parameters_and_Arguments.md#generic-where-clause)<sub>可选</sub>
>
@ -1194,16 +1282,19 @@ if let actualInstance = SomeStruct(input: "Hello") {
更多关于可失败构造器的信息和例子，请参阅 [可失败构造器](../chapter2/14_Initialization.md#failable_initializers)。
###### grammer_of_an_initializer_declaration {#grammer_of_an_initializer_declaration}
#### grammer_of_an_initializer_declaration {#grammer_of_an_initializer_declaration}
> 构造器声明语法
>
> ###### initializer-declaration {#initializer-declaration}
>
#### initializer-declaration {#initializer-declaration}
>
> *构造器声明* → [*构造器头*](#initializer-head) [*泛型形参子句*](08_Generic_Parameters_and_Arguments.md#generic-parameter-clause)<sub>可选</sub> [*参数子句*](#parameter-clause) **throws**<sub>可选</sub> [*泛型 where 子句*](08_Generic_Parameters_and_Arguments.md#generic-where-clause)<sub>可选</sub> [*构造器主体*](#initializer-body)
>
> *构造器声明* → [*构造器头*](#initializer-head) [*泛型形参子句*](08_Generic_Parameters_and_Arguments.md#generic-parameter-clause)<sub>可选</sub> [*参数子句*](#parameter-clause) **rethrows**<sub>可选</sub> [*泛型 where 子句*](08_Generic_Parameters_and_Arguments.md#generic-where-clause)<sub>可选</sub> [*构造器主体*](#initializer-body)
>
> ###### initializer-head {#initializer-head}
>
#### initializer-head {#initializer-head}
>
> *构造器头* → [*特性列表*](./07_Attributes.md#attributes)<sub>可选</sub> [*声明修饰符列表*](#declaration-modifiers)<sub>可选</sub> **init**
>
@ -1211,7 +1302,8 @@ if let actualInstance = SomeStruct(input: "Hello") {
>
> *构造器头* → [*特性列表*](./07_Attributes.md#attributes)<sub>可选</sub> [*声明修饰符列表*](#declaration-modifiers)<sub>可选</sub> **init** **!**
>
> ###### initializer-body {#initializer-body}
>
#### initializer-body {#initializer-body}
>
> *构造器主体* → [*代码块*](#code-block)
>
@ -1233,10 +1325,12 @@ deinit {
关于如何在类声明中使用析构器的例子，请参阅 [析构过程](../chapter2/15_Deinitialization.md)。
###### grammer_of_a_deinitializer_declaration {#grammer_of_a_deinitializer_declaration}
#### grammer_of_a_deinitializer_declaration {#grammer_of_a_deinitializer_declaration}
> 析构器声明语法
>
> ###### deinitializer-declaration {#deinitializer-declaration}
>
#### deinitializer-declaration {#deinitializer-declaration}
>
> *析构器声明* → [*特性列表*](./07_Attributes.md#attributes)<sub>可选</sub> **deinit** [*代码块*](#code-block)
>
@ -1416,15 +1510,18 @@ extension Array: Loggable where Element: MarkedLoggable { }
// 报错: redundant conformance of 'Array<Element>' to protocol 'Loggable'
```
###### grammer_of_an_extension_declaration {#grammer_of_an_extension_declaration}
#### grammer_of_an_extension_declaration {#grammer_of_an_extension_declaration}
> 扩展声明语法
>
>
> ###### extension-declaration {#extension-declaration}
>
#### extension-declaration {#extension-declaration}
>
> *扩展声明* → [特性](./07_Attributes.md#type_attributes)<sub>可选</sub> [访问级别修饰符](#access-level-modifier)<sub>可选</sub> **extension** [*类型标识符*](03_Types.md#type-identifier) [*类型-继承-子句*](./03_Types.md#type-inheritance-clause)<sub>可选</sub> [*泛型 where 子句*](./09_Generic_Parameters_and_Arguments.md#generic-where-clause)<sub>可选</sub> [*扩展主体*](#extension-body)
>
> ###### extension-body {#extension-body}
>
#### extension-body {#extension-body}
>
> *扩展主体* → **{** [*多条声明*](#declarations)<sub>可选</sub> **}**
>
@ -1464,11 +1561,13 @@ subscript (参数列表) -> 返回类型 {
更多关于下标的信息和例子，请参阅 [下标](../chapter2/12_Subscripts.md)。
###### grammer_of_a_subscript_declaration {#grammer_of_a_subscript_declaration}
#### grammer_of_a_subscript_declaration {#grammer_of_a_subscript_declaration}
> 下标声明语法
>
>
> ###### subscript-declaration {#subscript-declaration}
>
#### subscript-declaration {#subscript-declaration}
>
> *下标声明* → [*下标头*](#subscript-head) [*下标结果*](#subscript-result) [*泛型 where 子句*](08_Generic_Parameters_and_Arguments.md#generic-where-clause)<sub>可选</sub> [*代码块*](#code-block)
>
@ -1476,11 +1575,13 @@ subscript (参数列表) -> 返回类型 {
>
> *下标声明* → [*下标头*](#subscript-head) [*下标结果*](#subscript-result) [*泛型 where 子句*](08_Generic_Parameters_and_Arguments.md#generic-where-clause)<sub>可选</sub> [*getter-setter 关键字代码块*](#getter-setter-keyword-block)
>
> ###### subscript-head {#subscript-head}
>
#### subscript-head {#subscript-head}
>
> *下标头* → [*特性列表*](./07_Attributes.md#attributes)<sub>可选</sub> [*声明修饰符列表*](#declaration-modifiers)<sub>可选</sub> **subscript** [*泛型参数子句*](08_Generic_Parameters_and_Arguments.md#generic-parameter-clause)<sub>可选</sub> [*参数子句*](#parameter-clause)
>
> ###### subscript-result {#subscript-result}
>
#### subscript-result {#subscript-result}
>
> *下标结果* → **->** [*特性列表*](./07_Attributes.md#attributes)<sub>可选</sub> [*类型*](./03_Types.md#type)
>
@ -1524,24 +1625,30 @@ postfix operator 运算符名称 {}
声明了一个新的运算符以后，需要实现一个跟这个运算符同名的函数来实现这个运算符。如果是实现一个前缀或者后缀运算符，也必须使用相符的 `prefix` 或者 `postfix` 声明修饰符标记函数声明。如果是实现中缀运算符，则不需要使用 `infix` 声明修饰符标记函数声明。关于如何实现一个新的运算符的例子，请参阅 [自定义运算符](../chapter2/26_Advanced_Operators.md#custom_operators)。
###### grammer_of_an_operator_declaration {#grammer_of_an_operator_declaration}
#### grammer_of_an_operator_declaration {#grammer_of_an_operator_declaration}
> 运算符声明语法
>
###### operator-declaration {#operator-declaration}
#### operator-declaration {#operator-declaration}
> *运算符声明* → [*前缀运算符声明*](#prefix-operator-declaration) | [*后缀运算符声明*](#postfix-operator-declaration) | [*中缀运算符声明*](#infix-operator-declaration)
>
###### prefix-operator-declaration {#prefix-operator-declaration}
#### prefix-operator-declaration {#prefix-operator-declaration}
> *前缀运算符声明* → **prefix** **运算符** [*运算符*](./02_Lexical_Structure.md#operator) **{** **}**
>
> ###### postfix-operator-declaration {#postfix-operator-declaration}
>
#### postfix-operator-declaration {#postfix-operator-declaration}
>
> *后缀运算符声明* → **postfix** **运算符** [*运算符*](./02_Lexical_Structure.html#operator) **{** **}**
>
> ###### infix-operator-declaration {#infix-operator-declaration}
>
#### infix-operator-declaration {#infix-operator-declaration}
>
> *中缀运算符声明* → **infix** **运算符** [*运算符*](./02_Lexical_Structure.md#operator) **{** [*中缀运算符属性*](#infix-operator-attributes)<sub>可选</sub> **}**
>
###### infix-operator-group {#infix-operator-group}
#### infix-operator-group {#infix-operator-group}
> *中缀运算符组* → [*优先级组名称*](#precedence-group-name)
>
@ -1571,43 +1678,52 @@ Swift 定义了大量的优先级组来与标准库的运算符配合使用，
优先级组的赋值性表示在包含可选链操作时的运算符优先级。当设为 true 时，与优先级组对应的运算符在可选链操作中使用和标准库中赋值运算符同样的分组规则，当设为 false 或者不设置，该优先级组的运算符与不赋值的运算符遵循同样的可选链规则。
###### grammer_of_a_precedence_group_declaration {#grammer_of_a_precedence_group_declaration}
#### grammer_of_a_precedence_group_declaration {#grammer_of_a_precedence_group_declaration}
> 优先级组声明语法
>
###### precedence-group-declaration {#precedence-group-declaration}
#### precedence-group-declaration {#precedence-group-declaration}
> *优先级组声明* → **precedence**[*优先级组名称*](#precedence-group-name){[*多优先级组属性*](#precedence-group-attributes)<sub>可选</sub> }
>
###### precedence-group-attributes {#precedence-group-attributes}
#### precedence-group-attributes {#precedence-group-attributes}
> *优先级组属性* → [*优先级组属性*](#precedence-group-attribute)[*多优先级组属性*](#precedence-group-attributes)<sub>可选</sub> **{** **}**
>
###### precedence-group-attribute {#precedence-group-attribute}
#### precedence-group-attribute {#precedence-group-attribute}
> *优先级组属性* → [*优先级组关系*](#precedence-group-relation)
>
> *优先级组属性* → [*优先级组赋值性*](#precedence-group-assignment)
>
> *优先级组属性* → [*优先级组相关性*](#precedence-group-associativity)
>
> ###### precedence-group-relation {#precedence-group-relation}
>
#### precedence-group-relation {#precedence-group-relation}
>
> *优先级组关系* → **higherThan:**[*多优先级组名称*](#precedence-group-names)
>
> *优先级组关系* → **lowerThan:**[*多优先级组名称*](#precedence-group-names)
>
> ###### precedence-group-assignment {#precedence-group-assignment}
>
#### precedence-group-assignment {#precedence-group-assignment}
>
> *优先级组赋值* → **assignment:**[*布尔字面值*](./02_Lexical_Structure.md#boolean-literal)
>
###### precedence-group-associativity {#precedence-group-associativity}
#### precedence-group-associativity {#precedence-group-associativity}
> *优先级组结合性* → **associativity:left**
>
> *优先级组结合性* → **associativity:right**
>
> *优先级组结合性* → **associativity:none**
>
###### precedence-group-names {#precedence-group-names}
#### precedence-group-names {#precedence-group-names}
> *多优先级组名称* → [*优先级组名称*](#precedence-group-name) | [*优先级组名称*](#precedence-group-name) | [*优先级组名称*](#precedence-group-name)
>
###### precedence-group-name {#precedence-group-name}
#### precedence-group-name {#precedence-group-name}
> *优先级组名称* →[*标识符*](./02_Lexical_Structure.md#identifier)
>
@ -1671,19 +1787,23 @@ Swift 提供了三个级别的访问控制：`public`、`internal` 和 `private`
以上访问级别修饰符都可以选择带上一个参数，该参数由一对圆括号和其中的 `set` 关键字组成（例如，`private(set)`）。使用这种形式的访问级别修饰符来限制某个属性或下标的 setter 的访问级别低于其本身的访问级别，正如 [Getter 和 Setter](../chapter2/25_Access_Control.md#getters_and_setters) 中所讨论的。
###### grammer_of_a_declaration_modifier {#grammer_of_a_declaration_modifier}
#### grammer_of_a_declaration_modifier {#grammer_of_a_declaration_modifier}
> 声明修饰符的语法
>
###### declaration-modifier {#declaration-modifier}
#### declaration-modifier {#declaration-modifier}
> *声明修饰符* → **class** | **convenience**| **dynamic** | **final** | **infix** | **lazy** | **mutating** | **nonmutating** | **optional** | **override** | **postfix** | **prefix** | **required** | **static** | **unowned** | **unowned ( safe )** | **unowned ( unsafe )** | **weak**
>
> 声明修饰符 → [*访问级别修饰符*](#access-level-modifier)
>
> ###### declaration-modifiers {#declaration-modifiers}
>
#### declaration-modifiers {#declaration-modifiers}
>
> *声明修饰符列表* → [*声明修饰符*](#declaration-modifier) [*声明修饰符列表*](#declaration-modifiers)<sub>可选</sub>
>
###### access-level-modifier {#access-level-modifier}
#### access-level-modifier {#access-level-modifier}
> 访问级别修饰符 → **internal** | **internal ( set )**
>
> 访问级别修饰符 → **private** | **private ( set )**

18
source/chapter3/07_Attributes.md
View File

@ -358,28 +358,34 @@ convention 特性总是与下面的参数之一一起出现。
> 特性语法
>
>
> ###### attribute {#attribute}
>
#### attribute {#attribute}
>
> *特性*→ [特性名](#attribute_name) [特性参数子句](#atribute_argument_clause)<sub>可选</sub>
>
> ###### attribute_name {#attribute_name}
>
#### attribute_name {#attribute_name}
>
> *特性名* → [标识符](./02_Lexical_Structure.md#identifier)
>
> ###### atribute_argument_clause {#atribute_argument_clause}
>
#### atribute_argument_clause {#atribute_argument_clause}
>
> *特性参数子句* → **(** [均衡令牌列表](#balanced_tokens)<sub>可选</sub> **)**
>
> ###### attributes {#attributes}
>
#### attributes {#attributes}
>
> *特性列表* → [特性](#attribute) [特性列表](#attributes)<sub>可选</sub>
>
>
> ###### balanced_tokens {#balanced_tokens}
>
#### balanced_tokens {#balanced_tokens}
>
> *均衡令牌列表* → [均衡令牌](#balanced_token) [均衡令牌列表](#balanced_tokens)<sub>可选</sub>
>
> ###### balanced_token {#balanced_token}
>
#### balanced_token {#balanced_token}
>
> *均衡令牌* → **(** [均衡令牌列表](#balanced_tokens)<sub>可选</sub> **)**
>

39
source/chapter3/08_Patterns.md
View File

@ -10,7 +10,8 @@ Swift 中的模式分为两类：一种能成功匹配任何类型的值，另
> 模式语法
>
###### pattern {#pattern}
#### pattern {#pattern}
> *模式* → [*通配符模式*](#wildcard_pattern) [*类型标注*](03_Types.md#type-annotation)<sub>可选</sub>
>
> *模式* → [*标识符模式*](#identifier_pattern) [*类型标注*](03_Types.md#type-annotation)<sub>可选</sub>
@ -40,7 +41,8 @@ for _ in 1...3 {
> 通配符模式语法
>
###### wildcard-pattern {#wildcard-pattern}
#### wildcard-pattern {#wildcard-pattern}
> *通配符模式* → **_**
>
@ -57,7 +59,8 @@ let someValue = 42
> 标识符模式语法
>
###### identifier-pattern {#identifier-pattern}
#### identifier-pattern {#identifier-pattern}
> *标识符模式* → [*标识符*](./02_Lexical_Structure.md#identifier)
>
@ -80,7 +83,8 @@ case let (x, y):
> 值绑定模式语法
>
###### value-binding-pattern {#value-binding-pattern}
#### value-binding-pattern {#value-binding-pattern}
> *值绑定模式* → **var** [*模式*](#pattern) | **let** [*模式*](#pattern)
>
@ -109,13 +113,16 @@ let (a): Int = 2 // a: Int = 2
> 元组模式语法
>
###### tuple-pattern {#tuple-pattern}
#### tuple-pattern {#tuple-pattern}
> *元组模式* → **(** [*元组模式元素列表*](#tuple-pattern-element-list)<sub>可选</sub> **)**
>
###### tuple-pattern-element-list {#tuple-pattern-element-list}
#### tuple-pattern-element-list {#tuple-pattern-element-list}
> *元组模式元素列表* → [*元组模式元素*](#tuple-pattern-element) | [*元组模式元素*](#tuple-pattern-element) **,** [*元组模式元素列表*](#tuple-pattern-element-list)
>
###### tuple-pattern-element {#tuple-pattern-element}
#### tuple-pattern-element {#tuple-pattern-element}
> *元组模式元素* → [*模式*](#pattern)
>
@ -126,7 +133,8 @@ let (a): Int = 2 // a: Int = 2
> 枚举用例模式语法
>
###### enum-case-pattern {#enum-case-pattern}
#### enum-case-pattern {#enum-case-pattern}
> *枚举用例模式* → [*类型标识*](./03_Types.md#type-identifier)<sub>可选</sub> **.** [*枚举用例名*](./06_Declarations.md#enum-case-name) [*元组模式*](#tuple-pattern)<sub>可选</sub>
>
@ -163,7 +171,8 @@ for case let number? in arrayOfOptinalInts {
> 可选模式语法
>
###### optional-pattern {#optional-pattern}
#### optional-pattern {#optional-pattern}
> *可选模式* → [*标识符模式*](./03_Types.md#type-identifier) **?**
>
@ -183,13 +192,16 @@ for case let number? in arrayOfOptinalInts {
> 类型转换模式语法
>
###### type-casting-pattern {#type-casting-pattern}
#### type-casting-pattern {#type-casting-pattern}
> *类型转换模式* → [*is 模式*](#is-pattern) | [*as 模式*](#as-pattern)
>
###### is-pattern {#is-pattern}
#### is-pattern {#is-pattern}
> *is 模式* → **is** [*类型*](./03_Types.md#type)
>
###### as-pattern {#as-pattern}
#### as-pattern {#as-pattern}
> *as 模式* → [*模式*](#pattern) **as** [*类型*](03_Types.md#type)
>
@ -231,6 +243,7 @@ default:
> 表达式模式语法
>
###### expression-pattern {#expression-pattern}
#### expression-pattern {#expression-pattern}
> *表达式模式* → [*表达式*](./04_Expressions.md#expression)
>

33
source/chapter3/09_Generic_Parameters_and_Arguments.md
View File

@ -56,36 +56,44 @@ simpleMax(3.14159, 2.71828) // T 被推断为 Double 类型
> 泛型形参子句语法
>
###### generic-parameter-clause {#generic-parameter-clause}
#### generic-parameter-clause {#generic-parameter-clause}
> *泛型形参子句* → **<** [*泛型形参列表*](#generic-parameter-list) [*约束子句*](#requirement-clause)<sub>可选</sub> **>**
>
###### generic-parameter-list {#generic-parameter-list}
#### generic-parameter-list {#generic-parameter-list}
> *泛型形参列表* → [*泛形形参*](#generic-parameter) | [*泛形形参*](#generic-parameter) **,** [*泛型形参列表*](#generic-parameter-list)
>
###### generic-parameter {#generic-parameter}
#### generic-parameter {#generic-parameter}
> *泛形形参* → [*类型名称*](./03_Types.md#type-name)
>
> *泛形形参* → [*类型名称*](./03_Types.md#type-name) **:** [*类型标识符*](./03_Types.md#type-identifier)
>
> *泛形形参* → [*类型名称*](./03_Types.md#type-name) **:** [*协议合成类型*](./03_Types.md#protocol-composition-type)
>
> ###### requirement-clause {#requirement-clause}
>
#### requirement-clause {#requirement-clause}
>
> *约束子句* → **where** [*约束列表*](#requirement-list)
>
###### requirement-list {#requirement-list}
#### requirement-list {#requirement-list}
> *约束列表* → [*约束*](#requirement) | [*约束*](#requirement) **,** [*约束列表*](#requirement-list)
>
###### requirement {#requirement}
#### requirement {#requirement}
> *约束* → [*一致性约束*](#conformance-requirement) | [*同类型约束*](#same-type-requirement)
>
> ###### conformance-requirement {#conformance-requirement}
>
#### conformance-requirement {#conformance-requirement}
>
> *一致性约束* → [*类型标识符*](./03_Types.md#type-identifier) **:** [*类型标识符*](./03_Types.md#type-identifier)
>
> *一致性约束* → [*类型标识符*](./03_Types.md#type-identifier) **:** [*协议合成类型*](./03_Types.md#protocol-composition-type)
>
###### same-type-requirement {#same-type-requirement}
#### same-type-requirement {#same-type-requirement}
> *同类型约束* → [*类型标识符*](./03_Types.md#type-identifier) **==** [*类型*](./03_Types.md#type)
>
@ -116,12 +124,15 @@ let arrayOfArrays: Array<Array<Int>> = [[1, 2, 3], [4, 5, 6], [7, 8, 9]]
> 泛型实参子句语法
>
###### generic-argument-clause {#generic-argument-clause}
#### generic-argument-clause {#generic-argument-clause}
> *泛型实参子句* → **<** [*泛型实参列表*](#generic-argument-list) **>**
>
###### generic-argument-list {#generic-argument-list}
#### generic-argument-list {#generic-argument-list}
> *泛型实参列表* → [*泛型实参*](#generic-argument) | [*泛型实参*](#generic-argument) **,** [*泛型实参列表*](#generic-argument-list)
>
###### generic-argument {#generic-argument}
#### generic-argument {#generic-argument}
> *泛型实参* → [*类型*](./03_Types.md#type)
>