github_mirrors/rust-book-cn
1
0
Fork 0
mirror of https://github.com/rust-lang-cn/book-cn.git synced 2025-02-02 23:38:41 +08:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #52 from YangFong/dev-appendix-01

Browse Source 
feat: Move async and await keywords to 'Currently in Use'
This commit is contained in:
Aaran Xu 2022-01-18 03:39:53 +08:00 committed by GitHub
commit fd03d732f3
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 55 additions and 56 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

111
src/appendix-01-keywords.md
View File

@ -1,7 +1,6 @@
## 附录 A：关键字 ## 附录 A：关键字
下面的列表包含 Rust 中正在使用或者以后会用到的关键字。因此，这些关键字不能被用作标识符（除了 “[原始标识符][raw-identifiers]” 部分介绍的原始标识符），这包括函数、变量、参数、结构体字段、模块、crate、常量、宏、静态值、属性、类型、trait 或生命周期 下面的列表包含 Rust 中正在使用或者以后会用到的关键字。因此，这些关键字不能被用作标识符（除了 “[原始标识符][raw-identifiers]” 部分介绍的原始标识符），这包括函数、变量、参数、结构体字段、模块、crate、常量、宏、静态值、属性、类型、trait 或生命周期的名字。
的名字。
[raw-identifiers]: #raw-identifiers [raw-identifiers]: #raw-identifiers
@ -9,68 +8,68 @@
如下关键字目前有对应其描述的功能。 如下关键字目前有对应其描述的功能。
* `as` - 强制类型转换，消除特定包含项的 trait 的歧义，或者对 `use` 和 `extern crate` 语句中的项重命名 - `as` - 强制类型转换，消除特定包含项的 trait 的歧义，或者对 `use` 和 `extern crate` 语句中的项重命名
* `break` - 立刻退出循环 - `async` - 返回一个 `Future` 而不是阻塞当前线程
* `const` - 定义常量或不变裸指针（constant raw pointer） - `await` - 暂停执行，直到 `Future` 的结果准备好
* `continue` - 继续进入下一次循环迭代 - `break` - 立刻退出循环
* `crate` - 链接（link）一个外部 **crate** 或一个代表宏定义的 **crate** 的宏变量 - `const` - 定义常量或不变裸指针（constant raw pointer）
* `dyn` - 动态分发 trait 对象 - `continue` - 继续进入下一次循环迭代
* `else` - 作为 `if` 和 `if let` 控制流结构的 fallback - `crate` - 链接（link）一个外部 **crate** 或一个代表宏定义的 **crate** 的宏变量
* `enum` - 定义一个枚举 - `dyn` - 动态分发 trait 对象
* `extern` - 链接一个外部 **crate** 、函数或变量 - `else` - 作为 `if` 和 `if let` 控制流结构的 fallback
* `false` - 布尔字面值 `false` - `enum` - 定义一个枚举
* `fn` - 定义一个函数或 **函数指针类型** (*function pointer type*) - `extern` - 链接一个外部 **crate** 、函数或变量
* `for` - 遍历一个迭代器或实现一个 trait 或者指定一个更高级的生命周期 - `false` - 布尔字面值 `false`
* `if` - 基于条件表达式的结果分支 - `fn` - 定义一个函数或 **函数指针类型** (*function pointer type*)
* `impl` - 实现自有或 trait 功能 - `for` - 遍历一个迭代器或实现一个 trait 或者指定一个更高级的生命周期
* `in` - `for` 循环语法的一部分 - `if` - 基于条件表达式的结果分支
* `let` - 绑定一个变量 - `impl` - 实现自有或 trait 功能
* `loop` - 无条件循环 - `in` - `for` 循环语法的一部分
* `match` - 模式匹配 - `let` - 绑定一个变量
* `mod` - 定义一个模块 - `loop` - 无条件循环
* `move` - 使闭包获取其所捕获项的所有权 - `match` - 模式匹配
* `mut` - 表示引用、裸指针或模式绑定的可变性 - `mod` - 定义一个模块
* `pub` - 表示结构体字段、`impl` 块或模块的公有可见性 - `move` - 使闭包获取其所捕获项的所有权
* `ref` - 通过引用绑定 - `mut` - 表示引用、裸指针或模式绑定的可变性
* `return` - 从函数中返回 - `pub` - 表示结构体字段、`impl` 块或模块的公有可见性
* `Self` - 实现 trait 的类型的类型别名 - `ref` - 通过引用绑定
* `self` - 表示方法本身或当前模块 - `return` - 从函数中返回
* `static` - 表示全局变量或在整个程序执行期间保持其生命周期 - `Self` - 实现 trait 的类型的类型别名
* `struct` - 定义一个结构体 - `self` - 表示方法本身或当前模块
* `super` - 表示当前模块的父模块 - `static` - 表示全局变量或在整个程序执行期间保持其生命周期
* `trait` - 定义一个 trait - `struct` - 定义一个结构体
* `true` - 布尔字面值 `true` - `super` - 表示当前模块的父模块
* `type` - 定义一个类型别名或关联类型 - `trait` - 定义一个 trait
* `unsafe` - 表示不安全的代码、函数、trait 或实现 - `true` - 布尔字面值 `true`
* `use` - 引入外部空间的符号 - `type` - 定义一个类型别名或关联类型
* `where` - 表示一个约束类型的从句 - `unsafe` - 表示不安全的代码、函数、trait 或实现
* `while` - 基于一个表达式的结果判断是否进行循环 - `use` - 引入外部空间的符号
- `where` - 表示一个约束类型的从句
- `while` - 基于一个表达式的结果判断是否进行循环
### 保留做将来使用的关键字 ### 保留做将来使用的关键字
如下关键字没有任何功能，不过由 Rust 保留以备将来的应用。 如下关键字没有任何功能，不过由 Rust 保留以备将来应用。
* `abstract` - `abstract`
* `async` - `become`
* `await` - `box`
* `become` - `do`
* `box` - `final`
* `do` - `macro`
* `final` - `override`
* `macro` - `priv`
* `override` - `try`
* `priv` - `typeof`
* `try` - `unsized`
* `typeof` - `virtual`
* `unsized` - `yield`
* `virtual`
* `yield`
### 原始标识符 ### 原始标识符
原始标识符（Raw identifiers）允许你使用通常不能使用的关键字，其带有 `r#` 前缀。 原始标识符（Raw identifiers）允许你使用通常不能使用的关键字，其带有 `r#` 前缀。
例如，`match` 是关键字。如果尝试编译如下使用 `match` 作为名字的函数： 例如，`match` 是关键字。如果尝试编译如下使用 `match` 作为名称的函数：
```rust,ignore,does_not_compile ```rust,ignore,does_not_compile
fn match(needle: &str, haystack: &str) -> bool { fn match(needle: &str, haystack: &str) -> bool {
@ -104,6 +103,6 @@ fn main() {
此代码编译没有任何错误。注意 `r#` 前缀需同时用于函数名定义和 `main` 函数中的调用。 此代码编译没有任何错误。注意 `r#` 前缀需同时用于函数名定义和 `main` 函数中的调用。
原始标识符允许使用你选择的任何单词作为标识符，即使该单词恰好是保留关键字。 此外，原始标识符允许你使用以不同于你的 crate 使用的 Rust 版本编写的库。比如，`try` 在 2015 edition 中不是关键字，而在 2018 edition 则是。所以如果用 2015 edition 编写的库中带有 `try` 函数，在 2018 edition 中调用时就需要使用原始标识符语法，在这里是 `r#try`。有关版本的更多信息，请参见[附录 E][appendix-e]. 原始标识符允许使用你选择的任何单词作为标识符，即使该单词恰好是保留关键字。 此外，原始标识符允许你使用以不同于你的 crate 使用的 Rust 版本编写的库。比如，`try` 在 2015 edition 中不是关键字，而在 2018 edition 则是。所以如果用 2015 edition 编写的库中带有 `try` 函数，在 2018 edition 中调用时就需要使用原始标识符语法，在这里是 `r#try`。有关版本的更多信息，请参见[附录 E][appendix-e]。
[appendix-e]: appendix-05-editions.html [appendix-e]: appendix-05-editions.html