From 90081ba814b5e2b74859cb8b213b1f5de83bb5a4 Mon Sep 17 00:00:00 2001 From: YangFong <70502828+YangFong@users.noreply.github.com> Date: Sun, 16 Jan 2022 11:03:55 +0800 Subject: [PATCH] feat: Move async and await keywords to 'Currently in Use' --- src/appendix-01-keywords.md | 111 ++++++++++++++++++------------------ 1 file changed, 55 insertions(+), 56 deletions(-) diff --git a/src/appendix-01-keywords.md b/src/appendix-01-keywords.md index ad9f053..e14a5a4 100644 --- a/src/appendix-01-keywords.md +++ b/src/appendix-01-keywords.md @@ -1,7 +1,6 @@ ## 附录 A:关键字 -下面的列表包含 Rust 中正在使用或者以后会用到的关键字。因此,这些关键字不能被用作标识符(除了 “[原始标识符][raw-identifiers]” 部分介绍的原始标识符),这包括函数、变量、参数、结构体字段、模块、crate、常量、宏、静态值、属性、类型、trait 或生命周期 -的名字。 +下面的列表包含 Rust 中正在使用或者以后会用到的关键字。因此,这些关键字不能被用作标识符(除了 “[原始标识符][raw-identifiers]” 部分介绍的原始标识符),这包括函数、变量、参数、结构体字段、模块、crate、常量、宏、静态值、属性、类型、trait 或生命周期的名字。 [raw-identifiers]: #raw-identifiers @@ -9,68 +8,68 @@ 如下关键字目前有对应其描述的功能。 -* `as` - 强制类型转换,消除特定包含项的 trait 的歧义,或者对 `use` 和 `extern crate` 语句中的项重命名 -* `break` - 立刻退出循环 -* `const` - 定义常量或不变裸指针(constant raw pointer) -* `continue` - 继续进入下一次循环迭代 -* `crate` - 链接(link)一个外部 **crate** 或一个代表宏定义的 **crate** 的宏变量 -* `dyn` - 动态分发 trait 对象 -* `else` - 作为 `if` 和 `if let` 控制流结构的 fallback -* `enum` - 定义一个枚举 -* `extern` - 链接一个外部 **crate** 、函数或变量 -* `false` - 布尔字面值 `false` -* `fn` - 定义一个函数或 **函数指针类型** (*function pointer type*) -* `for` - 遍历一个迭代器或实现一个 trait 或者指定一个更高级的生命周期 -* `if` - 基于条件表达式的结果分支 -* `impl` - 实现自有或 trait 功能 -* `in` - `for` 循环语法的一部分 -* `let` - 绑定一个变量 -* `loop` - 无条件循环 -* `match` - 模式匹配 -* `mod` - 定义一个模块 -* `move` - 使闭包获取其所捕获项的所有权 -* `mut` - 表示引用、裸指针或模式绑定的可变性 -* `pub` - 表示结构体字段、`impl` 块或模块的公有可见性 -* `ref` - 通过引用绑定 -* `return` - 从函数中返回 -* `Self` - 实现 trait 的类型的类型别名 -* `self` - 表示方法本身或当前模块 -* `static` - 表示全局变量或在整个程序执行期间保持其生命周期 -* `struct` - 定义一个结构体 -* `super` - 表示当前模块的父模块 -* `trait` - 定义一个 trait -* `true` - 布尔字面值 `true` -* `type` - 定义一个类型别名或关联类型 -* `unsafe` - 表示不安全的代码、函数、trait 或实现 -* `use` - 引入外部空间的符号 -* `where` - 表示一个约束类型的从句 -* `while` - 基于一个表达式的结果判断是否进行循环 +- `as` - 强制类型转换,消除特定包含项的 trait 的歧义,或者对 `use` 和 `extern crate` 语句中的项重命名 +- `async` - 返回一个 `Future` 而不是阻塞当前线程 +- `await` - 暂停执行,直到 `Future` 的结果准备好 +- `break` - 立刻退出循环 +- `const` - 定义常量或不变裸指针(constant raw pointer) +- `continue` - 继续进入下一次循环迭代 +- `crate` - 链接(link)一个外部 **crate** 或一个代表宏定义的 **crate** 的宏变量 +- `dyn` - 动态分发 trait 对象 +- `else` - 作为 `if` 和 `if let` 控制流结构的 fallback +- `enum` - 定义一个枚举 +- `extern` - 链接一个外部 **crate** 、函数或变量 +- `false` - 布尔字面值 `false` +- `fn` - 定义一个函数或 **函数指针类型** (*function pointer type*) +- `for` - 遍历一个迭代器或实现一个 trait 或者指定一个更高级的生命周期 +- `if` - 基于条件表达式的结果分支 +- `impl` - 实现自有或 trait 功能 +- `in` - `for` 循环语法的一部分 +- `let` - 绑定一个变量 +- `loop` - 无条件循环 +- `match` - 模式匹配 +- `mod` - 定义一个模块 +- `move` - 使闭包获取其所捕获项的所有权 +- `mut` - 表示引用、裸指针或模式绑定的可变性 +- `pub` - 表示结构体字段、`impl` 块或模块的公有可见性 +- `ref` - 通过引用绑定 +- `return` - 从函数中返回 +- `Self` - 实现 trait 的类型的类型别名 +- `self` - 表示方法本身或当前模块 +- `static` - 表示全局变量或在整个程序执行期间保持其生命周期 +- `struct` - 定义一个结构体 +- `super` - 表示当前模块的父模块 +- `trait` - 定义一个 trait +- `true` - 布尔字面值 `true` +- `type` - 定义一个类型别名或关联类型 +- `unsafe` - 表示不安全的代码、函数、trait 或实现 +- `use` - 引入外部空间的符号 +- `where` - 表示一个约束类型的从句 +- `while` - 基于一个表达式的结果判断是否进行循环 ### 保留做将来使用的关键字 -如下关键字没有任何功能,不过由 Rust 保留以备将来的应用。 +如下关键字没有任何功能,不过由 Rust 保留以备将来应用。 -* `abstract` -* `async` -* `await` -* `become` -* `box` -* `do` -* `final` -* `macro` -* `override` -* `priv` -* `try` -* `typeof` -* `unsized` -* `virtual` -* `yield` +- `abstract` +- `become` +- `box` +- `do` +- `final` +- `macro` +- `override` +- `priv` +- `try` +- `typeof` +- `unsized` +- `virtual` +- `yield` ### 原始标识符 原始标识符(Raw identifiers)允许你使用通常不能使用的关键字,其带有 `r#` 前缀。 -例如,`match` 是关键字。如果尝试编译如下使用 `match` 作为名字的函数: +例如,`match` 是关键字。如果尝试编译如下使用 `match` 作为名称的函数: ```rust,ignore,does_not_compile fn match(needle: &str, haystack: &str) -> bool { @@ -104,6 +103,6 @@ fn 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