typos: `列表` to `示例` close #905

pull/908/head
kazeno 3 days ago
parent 0ce91ca674
commit 9c6d2c74c4

@ -49,7 +49,7 @@
{{#rustdoc_include ../listings/ch08-common-collections/listing-08-04/src/main.rs:here}}
```
<span class="caption">列表 8-4使用索引语法或 `get` 方法来访问 vector 中的项</span>
<span class="caption">示例 8-4使用索引语法或 `get` 方法来访问 vector 中的项</span>
这里有几个细节需要注意。我们使用索引值 `2` 来获取第三个元素,因为索引是从数字 0 开始的。使用 `&``[]` 会得到一个索引位置元素的引用。当使用索引作为参数调用 `get` 方法时,会得到一个可以用于 `match``Option<&T>`

@ -43,7 +43,7 @@
可以改变 `Cons` 的定义来存放一个引用,不过接着必须指定生命周期参数。通过指定生命周期参数,表明列表中的每一个元素都至少与列表本身存在的一样久。这是示例 15-17 中元素与列表的情况,但并不是所有情况都如此。
相反,我们修改 `List` 的定义为使用 `Rc<T>` 代替 `Box<T>`,如列表 15-18 所示。现在每一个 `Cons` 变量都包含一个值和一个指向 `List``Rc<T>`。当创建 `b` 时,不同于获取 `a` 的所有权,这里会克隆 `a` 所包含的 `Rc<List>`,这会将引用计数从 1 增加到 2 并允许 `a``b` 共享 `Rc<List>` 中数据的所有权。创建 `c` 时同样会克隆 `a`,这会将引用计数从 2 增加为 3。每次调用 `Rc::clone``Rc<List>` 中数据的引用计数都会增加,直到有零个引用之前其数据都不会被清理。
相反,我们修改 `List` 的定义为使用 `Rc<T>` 代替 `Box<T>`,如示例 15-18 所示。现在每一个 `Cons` 变量都包含一个值和一个指向 `List``Rc<T>`。当创建 `b` 时,不同于获取 `a` 的所有权,这里会克隆 `a` 所包含的 `Rc<List>`,这会将引用计数从 1 增加到 2 并允许 `a``b` 共享 `Rc<List>` 中数据的所有权。创建 `c` 时同样会克隆 `a`,这会将引用计数从 2 增加为 3。每次调用 `Rc::clone``Rc<List>` 中数据的引用计数都会增加,直到有零个引用之前其数据都不会被清理。
<span class="filename">文件名src/main.rs</span>

@ -78,7 +78,7 @@
{{#rustdoc_include ../listings/ch18-oop/listing-18-14/src/lib.rs:here}}
```
<span class="caption">列表 18-14: 增加一个 `Post``content` 方法的占位实现,它总是返回一个空字符串 slice</span>
<span class="caption">示例 18-14: 增加一个 `Post``content` 方法的占位实现,它总是返回一个空字符串 slice</span>
通过增加这个 `content` 方法,示例 18-11 中直到第 7 行的代码能如期运行。
@ -220,7 +220,7 @@
{{#rustdoc_include ../listings/ch18-oop/listing-18-20/src/lib.rs:here}}
```
<span class="caption">列表 18-20: `PendingReviewPost` 通过调用 `DraftPost``request_review` 创建,`approve` 方法将 `PendingReviewPost` 变为发布的 `Post`</span>
<span class="caption">示例 18-20: `PendingReviewPost` 通过调用 `DraftPost``request_review` 创建,`approve` 方法将 `PendingReviewPost` 变为发布的 `Post`</span>
`request_review``approve` 方法获取 `self` 的所有权,因此会消费 `DraftPost``PendingReviewPost` 实例,并分别转换为 `PendingReviewPost` 和发布的 `Post`。这样在调用 `request_review` 之后就不会遗留任何 `DraftPost` 实例,后者同理。`PendingReviewPost` 并没有定义 `content` 方法,所以尝试读取其内容会导致编译错误,`DraftPost` 同理。因为唯一得到定义了 `content` 方法的 `Post` 实例的途径是调用 `PendingReviewPost``approve` 方法,而得到 `PendingReviewPost` 的唯一办法是调用 `DraftPost``request_review` 方法,现在我们就将发博文的工作流编码进了类型系统。

@ -76,7 +76,7 @@ match x {
{{#rustdoc_include ../listings/ch19-patterns-and-matching/listing-19-03/src/main.rs:here}}
```
<span class="caption">列表 19-3: 在 `for` 循环中使用模式来解构元组</span>
<span class="caption">示例 19-3: 在 `for` 循环中使用模式来解构元组</span>
示例 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}}
```
<span class="caption">列表 19-6: 在参数中使用模式的函数签名</span>
<span class="caption">示例 19-6: 在参数中使用模式的函数签名</span>
`x` 部分就是一个模式!类似于之前对 `let` 所做的,可以在函数参数中匹配元组。列表 19-7 将传递给函数的元组拆分为各个值:
`x` 部分就是一个模式!类似于之前对 `let` 所做的,可以在函数参数中匹配元组。示例 19-7 将传递给函数的元组拆分为各个值:
<span class="filename">文件名src/main.rs</span>
@ -146,7 +146,7 @@ let PATTERN = EXPRESSION;
{{#rustdoc_include ../listings/ch19-patterns-and-matching/listing-19-07/src/main.rs}}
```
<span class="caption">列表 19-7: 一个在参数中解构元组的函数</span>
<span class="caption">示例 19-7: 一个在参数中解构元组的函数</span>
这会打印出 `Current location: (3, 5)`。值 `&(3, 5)` 会匹配模式 `&(x, y)`,如此 `x` 得到了值 `3`,而 `y` 得到了值 `5`

@ -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}}

@ -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<T>` 上实现 `Display`,而孤儿规则阻止我们直接这么做,因为 `Display` trait 和 `Vec<T>` 都定义于我们的 crate 之外。可以创建一个包含 `Vec<T>` 实例的 `Wrapper` 结构体,接着可以如列表 20-24 那样在 `Wrapper` 上实现 `Display` 并使用 `Vec<T>` 的值:
例如,如果想要在 `Vec<T>` 上实现 `Display`,而孤儿规则阻止我们直接这么做,因为 `Display` trait 和 `Vec<T>` 都定义于我们的 crate 之外。可以创建一个包含 `Vec<T>` 实例的 `Wrapper` 结构体,接着可以如示例 20-24 那样在 `Wrapper` 上实现 `Display` 并使用 `Vec<T>` 的值:
<span class="filename">文件名src/main.rs</span>

Loading…
Cancel
Save