From 9c6d2c74c45ae40ece841c4ddd828d09d1efc209 Mon Sep 17 00:00:00 2001 From: kazeno Date: Mon, 28 Jul 2025 13:55:00 +0800 Subject: [PATCH] =?UTF-8?q?typos:=20`=E5=88=97=E8=A1=A8`=20to=20`=E7=A4=BA?= =?UTF-8?q?=E4=BE=8B`=20close=20#905?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- src/ch08-01-vectors.md | 2 +- src/ch15-04-rc.md | 2 +- src/ch18-03-oo-design-patterns.md | 4 ++-- src/ch19-01-all-the-places-for-patterns.md | 10 +++++----- src/ch19-03-pattern-syntax.md | 2 +- src/ch20-02-advanced-traits.md | 2 +- 6 files changed, 11 insertions(+), 11 deletions(-) diff --git a/src/ch08-01-vectors.md b/src/ch08-01-vectors.md index 42e7792..5f6f853 100644 --- a/src/ch08-01-vectors.md +++ b/src/ch08-01-vectors.md @@ -49,7 +49,7 @@ {{#rustdoc_include ../listings/ch08-common-collections/listing-08-04/src/main.rs:here}} ``` -列表 8-4：使用索引语法或 `get` 方法来访问 vector 中的项 +示例 8-4：使用索引语法或 `get` 方法来访问 vector 中的项 这里有几个细节需要注意。我们使用索引值 `2` 来获取第三个元素，因为索引是从数字 0 开始的。使用 `&` 和 `[]` 会得到一个索引位置元素的引用。当使用索引作为参数调用 `get` 方法时，会得到一个可以用于 `match` 的 `Option<&T>`。 diff --git a/src/ch15-04-rc.md b/src/ch15-04-rc.md index 8e3e363..320daa2 100644 --- a/src/ch15-04-rc.md +++ b/src/ch15-04-rc.md @@ -43,7 +43,7 @@ 可以改变 `Cons` 的定义来存放一个引用，不过接着必须指定生命周期参数。通过指定生命周期参数，表明列表中的每一个元素都至少与列表本身存在的一样久。这是示例 15-17 中元素与列表的情况，但并不是所有情况都如此。 -相反，我们修改 `List` 的定义为使用 `Rc` 代替 `Box`，如列表 15-18 所示。现在每一个 `Cons` 变量都包含一个值和一个指向 `List` 的 `Rc`。当创建 `b` 时，不同于获取 `a` 的所有权，这里会克隆 `a` 所包含的 `Rc`，这会将引用计数从 1 增加到 2 并允许 `a` 和 `b` 共享 `Rc` 中数据的所有权。创建 `c` 时同样会克隆 `a`，这会将引用计数从 2 增加为 3。每次调用 `Rc::clone`，`Rc` 中数据的引用计数都会增加，直到有零个引用之前其数据都不会被清理。 +相反，我们修改 `List` 的定义为使用 `Rc` 代替 `Box`，如示例 15-18 所示。现在每一个 `Cons` 变量都包含一个值和一个指向 `List` 的 `Rc`。当创建 `b` 时，不同于获取 `a` 的所有权，这里会克隆 `a` 所包含的 `Rc`，这会将引用计数从 1 增加到 2 并允许 `a` 和 `b` 共享 `Rc` 中数据的所有权。创建 `c` 时同样会克隆 `a`，这会将引用计数从 2 增加为 3。每次调用 `Rc::clone`，`Rc` 中数据的引用计数都会增加，直到有零个引用之前其数据都不会被清理。 文件名：src/main.rs diff --git a/src/ch18-03-oo-design-patterns.md b/src/ch18-03-oo-design-patterns.md index b24e77a..a4ed4cb 100644 --- a/src/ch18-03-oo-design-patterns.md +++ b/src/ch18-03-oo-design-patterns.md @@ -78,7 +78,7 @@ {{#rustdoc_include ../listings/ch18-oop/listing-18-14/src/lib.rs:here}} ``` -列表 18-14: 增加一个 `Post` 的 `content` 方法的占位实现，它总是返回一个空字符串 slice +示例 18-14: 增加一个 `Post` 的 `content` 方法的占位实现，它总是返回一个空字符串 slice 通过增加这个 `content` 方法，示例 18-11 中直到第 7 行的代码能如期运行。 @@ -220,7 +220,7 @@ {{#rustdoc_include ../listings/ch18-oop/listing-18-20/src/lib.rs:here}} ``` -列表 18-20: `PendingReviewPost` 通过调用 `DraftPost` 的 `request_review` 创建，`approve` 方法将 `PendingReviewPost` 变为发布的 `Post` +示例 18-20: `PendingReviewPost` 通过调用 `DraftPost` 的 `request_review` 创建，`approve` 方法将 `PendingReviewPost` 变为发布的 `Post` `request_review` 和 `approve` 方法获取 `self` 的所有权，因此会消费 `DraftPost` 和 `PendingReviewPost` 实例，并分别转换为 `PendingReviewPost` 和发布的 `Post`。这样在调用 `request_review` 之后就不会遗留任何 `DraftPost` 实例，后者同理。`PendingReviewPost` 并没有定义 `content` 方法，所以尝试读取其内容会导致编译错误，`DraftPost` 同理。因为唯一得到定义了 `content` 方法的 `Post` 实例的途径是调用 `PendingReviewPost` 的 `approve` 方法，而得到 `PendingReviewPost` 的唯一办法是调用 `DraftPost` 的 `request_review` 方法，现在我们就将发博文的工作流编码进了类型系统。 diff --git a/src/ch19-01-all-the-places-for-patterns.md b/src/ch19-01-all-the-places-for-patterns.md index 3fdb81b..a3701ed 100644 --- a/src/ch19-01-all-the-places-for-patterns.md +++ b/src/ch19-01-all-the-places-for-patterns.md @@ -76,7 +76,7 @@ match x { {{#rustdoc_include ../listings/ch19-patterns-and-matching/listing-19-03/src/main.rs:here}} ``` -列表 19-3: 在 `for` 循环中使用模式来解构元组 +示例 19-3: 在 `for` 循环中使用模式来解构元组 示例 19-3 的代码会打印出： @@ -130,15 +130,15 @@ let PATTERN = EXPRESSION; ### 函数参数 -函数参数也可以是模式。列表 19-6 中的代码声明了一个叫做 `foo` 的函数，它获取一个 `i32` 类型的参数 `x`，现在这看起来应该很熟悉： +函数参数也可以是模式。示例 19-6 中的代码声明了一个叫做 `foo` 的函数，它获取一个 `i32` 类型的参数 `x`，现在这看起来应该很熟悉： ```rust {{#rustdoc_include ../listings/ch19-patterns-and-matching/listing-19-06/src/main.rs:here}} ``` -列表 19-6: 在参数中使用模式的函数签名 +示例 19-6: 在参数中使用模式的函数签名 -`x` 部分就是一个模式！类似于之前对 `let` 所做的，可以在函数参数中匹配元组。列表 19-7 将传递给函数的元组拆分为各个值： +`x` 部分就是一个模式！类似于之前对 `let` 所做的，可以在函数参数中匹配元组。示例 19-7 将传递给函数的元组拆分为各个值： 文件名：src/main.rs @@ -146,7 +146,7 @@ let PATTERN = EXPRESSION; {{#rustdoc_include ../listings/ch19-patterns-and-matching/listing-19-07/src/main.rs}} ``` -列表 19-7: 一个在参数中解构元组的函数 +示例 19-7: 一个在参数中解构元组的函数 这会打印出 `Current location: (3, 5)`。值 `&(3, 5)` 会匹配模式 `&(x, y)`，如此 `x` 得到了值 `3`，而 `y` 得到了值 `5`。 diff --git a/src/ch19-03-pattern-syntax.md b/src/ch19-03-pattern-syntax.md index 3634651..ff74ed3 100644 --- a/src/ch19-03-pattern-syntax.md +++ b/src/ch19-03-pattern-syntax.md @@ -137,7 +137,7 @@ Rust 知道 `'c'` 位于第一个模式的范围内，并会打印出 `early ASC #### 解构嵌套的结构体和枚举 -目前为止，所有的例子都只匹配了深度为一级的结构体或枚举，不过当然也可以匹配嵌套的项！例如，我们可以重构列表 19-15 的代码在 `ChangeColor` 消息中同时支持 RGB 和 HSV 色彩模式，如示例 19-16 所示： +目前为止，所有的例子都只匹配了深度为一级的结构体或枚举，不过当然也可以匹配嵌套的项！例如，我们可以重构示例 19-15 的代码在 `ChangeColor` 消息中同时支持 RGB 和 HSV 色彩模式，如示例 19-16 所示： ```rust {{#rustdoc_include ../listings/ch19-patterns-and-matching/listing-19-16/src/main.rs}} diff --git a/src/ch20-02-advanced-traits.md b/src/ch20-02-advanced-traits.md index a7e1e75..f8e699c 100644 --- a/src/ch20-02-advanced-traits.md +++ b/src/ch20-02-advanced-traits.md @@ -254,7 +254,7 @@ Rust 既不能避免一个 trait 与另一个 trait 拥有相同名称的方法 在第十章的 [“为类型实现 trait”][implementing-a-trait-on-a-type] 部分，我们提到了孤儿规则（orphan rule），它规定只有当 trait 或类型至少有一方或两者都对于当前 crate 是本地时，才能在该类型上实现该 trait。一个绕开这个限制的方法是使用 **newtype 模式**（*newtype pattern*），它涉及到在一个元组结构体（第五章 [“用没有命名字段的元组结构体来创建不同的类型”][tuple-structs] 部分介绍了元组结构体）中创建一个新类型。这个元组结构体带有一个字段作为希望实现 trait 的类型的简单封装。由于这个封装类型对于 crate 是本地的，这样就可以在这个封装上实现 trait。*Newtype* 是一个源自 Haskell 编程语言的概念。使用这个模式没有运行时性能惩罚，这个封装类型在编译时就被省略了。 -例如，如果想要在 `Vec` 上实现 `Display`，而孤儿规则阻止我们直接这么做，因为 `Display` trait 和 `Vec` 都定义于我们的 crate 之外。可以创建一个包含 `Vec` 实例的 `Wrapper` 结构体，接着可以如列表 20-24 那样在 `Wrapper` 上实现 `Display` 并使用 `Vec` 的值： +例如，如果想要在 `Vec` 上实现 `Display`，而孤儿规则阻止我们直接这么做，因为 `Display` trait 和 `Vec` 都定义于我们的 crate 之外。可以创建一个包含 `Vec` 实例的 `Wrapper` 结构体，接着可以如示例 20-24 那样在 `Wrapper` 上实现 `Display` 并使用 `Vec` 的值： 文件名：src/main.rs