modify appendix derive and rust-version.md

pull/89/head
sunface 3 years ago
parent 3df6f84fcf
commit 95d9e1bd25

@ -16,7 +16,8 @@
- [基本语法](basic/intro.md)
- [变量与绑定](basic/variable.md)
- [基本类型(todo)](basic/type.md)
- [复合类型(todo)](basic/compound-type.md)
- [复合类型(todo)](basic/compound-type/intro.md)
- [Struct(todo)](basic/compound-type/struct.md)
- [函数与方法(todo)](basic/function-method.md)
- [格式化输出(todo)](basic/formatted-output.md)
- [字符串、数组与切片(todo)](basic/string-array-slice.md)

@ -1,93 +1,83 @@
## 附录 C可派生的 trait
在本书的各个部分中,我们讨论了可应用于结构体和枚举定义的 `derive` 属性。`derive` 属性会在使用 `derive` 语法标记的类型上生成对应 trait 的默认实现的代码
在本书的各个部分中,我们讨论了可应用于结构体和枚举定义的 `derive` 属性。被`derive`标记的对象会自动实现对应的默认特征代码,继承相应的功能
在本附录中提供了标准库中所有可以使用 `derive` 的 trait 的参考。这些部分涉及到:
在本附录中,我们列举了所有标准库存在的`derive`特征,每个特征覆盖了以下内容
* 该 trait 将会派生什么样的操作符和方法
* 由 `derive` 提供什么样的 trait 实现
* 由什么来实现类型的 trait
* 是否允许实现该 trait 的条件
* 需要 trait 操作的例子
* 该特征将会派生什么样的操作符和方法
* 由`derive` 提供什么样的特征实现
* 实现特征对于类型意味着什么
* 你需要什么条件来实现该特征
* 特征示例
如果你希望不同于 `derive` 属性所提供的行为,请查阅 [标准库文档](https://doc.rust-lang.org/std/index.html) 中每个 trait 的细节以了解如何手动实现它们。
如果你希望不同于 `derive` 属性所提供的行为,请查阅 [标准库文档](https://doc.rust-lang.org/std/index.html) 中每个特征的细节以了解如何手动实现它们。
标准库中定义的其它 trait 不能通过 `derive` 在类型上实现。这些 trait 不存在有意义的默认行为,所以由你负责以合理的方式实现它们。
除了本文列出的特征之外,标准库中定义的其它特征不能通过 `derive` 在类型上实现。这些特征不存在有意义的默认行为,所以由你负责以合理的方式实现它们。
一个无法被派生的 trait 的例子是为终端用户处理格式化的 `Display` 。你应该时常考虑使用合适的方法来为终端用户显示一个类型。终端用户应该看到类型的什么部分?他们会找出相关部分吗?对他们来说最关的数据格式是什么样的Rust 编译器没有这样的洞察力,因此无法为你提供合适的默认行为。
一个无法被派生的特征例子是为终端用户处理格式化的 `Display` 。你应该时常考虑使用合适的方法来为终端用户显示一个类型。终端用户应该看到类型的什么部分?他们会找出相关部分吗?对他们来说最关的数据格式是什么样的Rust 编译器没有这样的洞察力,因此无法为你提供合适的默认行为。
本附录所提供的可派生 trait 列表并不全面:库可以为其自己的 trait 实现 `derive`,可以使用 `derive` 的 trait 列表事实上是无限的。实现 `derive` 涉及到过程宏的应用,这在第十九章的 [“宏”][macros] 有介绍。
本附录所提供的可派生特征列表其实并不全面:库可以为其内部的特征实现 `derive`,因此除了本文列出的标准库`derive`之外,还有很多很多其它库的`derive`。实现 `derive` 涉及到过程宏的应用,这在第十九章的 [](../macro/intro)中有介绍。
### 用于程序员输出的 `Debug`
### 用于程序员Debug输出的 `Debug`
`Debug` trait 用于开启格式化字符串中的调试格式,其通过在 `{}` 占位符中增加 `:?` 表明。
`Debug`特征可以让指定对象输出调试格式的字符串,通过在 `{}` 占位符中增加 `:?` 表明,例如`println!("show you some debug info: {}", MyObject);`.
`Debug` trait 允许以调试目的来打印一个类型的实例,所以使用该类型的程序员可以在程序执行的特定时间点观察其实例
`Debug`特征允许以调试为目的来打印一个类型的实例,所以程序员可以在执行过程中看到该实例的具体信息
例如,在使用 `assert_eq!` 宏时,`Debug` trait 是必须的。如果等式断言失败,这个宏就把给定实例的值作为参数打印出来,如此程序员可以看到两个实例为什么不相等。
例如,在使用 `assert_eq!` 宏时,`Debug`特征是必须的。如果断言失败,这个宏就把给定实例的值打印出来,这样程序员就能看到两个实例为什么不相等。
### 等比较的 `PartialEq``Eq`
### 等比较的 `PartialEq``Eq`
`PartialEq` trait 可以比较一个类型的实例以检查是否相等,并开启了 `==``!=` 运算符的功能。
`PartialEq`特征可以比较一个类型的实例以检查是否相等,并开启了 `==``!=` 运算符的功能。
派生的 `PartialEq` 实现了 `eq` 方法。当 `PartialEq` 在结构体上派生时,只有*所有* 的字段都相等时两个实例才相等,同时只要有任何字段不相等则两个实例就不相等。当在枚举上派生时,每一个成员都和其自身相等,且和其他成员都不相等。
例如,当使用 `assert_eq!` 宏时,需要比较比较一个类型的两个实例是否相等,则 `PartialEq` trait 是必须的。
例如,当使用 `assert_eq!` 宏时,需要比较一个类型的两个实例是否相等,则 `PartialEq`特征是必须的。
`Eq` trait 没有方法。其作用是表明每一个被标记类型的值等于其自身。`Eq` trait 只能应用于那些实现了 `PartialEq` 的类型,但并非所有实现了 `PartialEq` 的类型都可以实现 `Eq`。浮点类型就是一个例子:浮点数的实现表明两个非数字(`NaN`not-a-number值是互不相等的。
`Eq`特征没有方法, 其作用是表明每一个被标记类型的值都等于其自身。`Eq`特征只能应用于那些实现了 `PartialEq` 的类型,但并非所有实现了 `PartialEq` 的类型都可以实现 `Eq`。浮点类型就是一个例子:浮点数的实现表明两个非数字(`NaN`not-a-number值是互不相等的。
例如,对于一个 `HashMap<K, V>` 中的 key 来说, `Eq` 是必须的,这样 `HashMap<K, V>` 就可以知道两个 key 是否一样
例如,对于一个 `HashMap<K, V>` 中的 key 来说, `Eq` 是必须的,这样 `HashMap<K, V>` 就可以知道两个 key 是否一样。
### 次序比较的 `PartialOrd``Ord`
### `PartialOrd``Ord`用于次序比较
`PartialOrd` trait 可以基于排序的目的而比较一个类型的实例。实现了 `PartialOrd` 的类型可以使用 `<``>`、`<=` 和 `>=` 操作符。但只能在同时实现了 `PartialEq` 的类型上使用 `PartialOrd`
`PartialOrd` 特征可以让一个类型的多个实例实现排序功能。实现了 `PartialOrd` 的类型可以使用 `<``>`、`<=` 和 `>=` 操作符。一个类型想要实现`PartialOrd`的前提是该类型已经实现了`PartialEq`
派生 `PartialOrd` 实现了 `partial_cmp` 方法,其返回一个 `Option<Ordering>` ,但当给定值无法产生顺序时将返回 `None`。尽管大多数类型的值都可以比较,但一个无法产生顺序的例子是:浮点类型的非数字值。当在浮点数上调用 `partial_cmp` 时,`NaN` 的浮点数将返回 `None`
派生 `PartialOrd` 实现了 `partial_cmp` 方法,一般情况下其返回一个 `Option<Ordering>`,但是当给定的值无法进行排序时将返回 `None`。尽管大多数类型的值都可以比较,但一个无法产生顺序的例子是:浮点类型的非数字值。当在浮点数上调用 `partial_cmp` 时,`NaN` 的浮点数将返回 `None`
当在结构体上派生时,`PartialOrd` 以在结构体定义中字段出现的顺序比较每个字段的值来比较两个实例。当在枚举上派生时,认为在枚举定义中声明较早的枚举变体小于其后的变体
当在结构体上派生时,`PartialOrd` 以在结构体定义中字段出现的顺序比较每个字段的值来比较两个实例。当在枚举上派生时,认为在枚举定义中声明较早的枚举项小于其后的枚举项
例如,对于来自于 `rand` crate 中`gen_range` 方法来说,当在一个大值和小值指定的范围内生成一个随机值时,`PartialOrd` trait 是必须的。
例如,对于来自于 `rand``gen_range` 方法来说,当在一个大值和小值指定的范围内生成一个随机值时,`PartialOrd` trait 是必须的。
`Ord` trait 也让你明白在一个带注解类型上的任意两个值存在有效顺序。`Ord` trait 实现了 `cmp` 方法,它返回一个 `Ordering` 而不是 `Option<Ordering>`,因为总存在一个合法的顺序。只可以在实现了 `PartialOrd``Eq``Eq` 依赖 `PartialEq`)的类型上使用 `Ord` trait 。当在结构体或枚举上派生时, `cmp` 和以 `PartialOrd` 派生实现的 `partial_cmp` 表现一致
对于派生了`Ord`特征的类型,任何两个该类型的值都能进行排序。`Ord`特征实现了 `cmp` 方法,它返回一个 `Ordering` 而不是 `Option<Ordering>`,因为总存在一个合法的顺序。一个类型要想使用`Ord`特征,它必须要先实现`PartialOrd` 和 `Eq`。当在结构体或枚举上派生时, `cmp`方法 和`PartialOrd`的 `partial_cmp`方法表现是一致的
例如,当在 `BTreeSet<T>`(一种基于有序值存储数据的数据结构)上存值时,`Ord` 是必须的。
### 复制值的 `Clone``Copy`
### `Clone``Copy`用于值复制
`Clone` trait 可以明确地创建一个值的深拷贝deep copy复制过程可能包含任意代码的执行以及堆上数据的复制。查阅第四章 [“变量和数据的交互方式:移动”][ways-variables-and-data-interact-clone] 以获取有关 `Clone` 的更多信息。
`Clone`特征用于创建一个值的深拷贝deep copy复制过程可能包含代码的执行以及堆上数据的复制。查阅 [“通过Clone来进行深拷贝”](../core/ownership.md#通过Clone来进行深拷贝)获取有关 `Clone` 的更多信息。
派生 `Clone` 实现了 `clone` 方法,其为整个的类型实现时,在类型的每一部分上调用了 `clone` 方法。这意味着类型中所有字段或值也必须实现了 `Clone`,这样才能够派生 `Clone`
派生 `Clone` 实现了 `clone` 方法,当为整个的类型实现`Clone`时,在该类型的每一部分上都会调用`clone` 方法。这意味着类型中所有字段或值也必须实现了 `Clone`,这样才能够派生 `Clone`
例如当在一个切片slice上调用 `to_vec` 方法时,`Clone` 是必须的。切片并不拥有其所包含实例的类型,但是从 `to_vec` 中返回的 vector 需要拥有其实例,因此,`to_vec` 在每个元素上调用 `clone`。因此,存储在切片中的类型必须实现 `Clone`
例如当在一个切片slice上调用 `to_vec` 方法时,`Clone` 是必须的。切片只是一个引用,并不拥有其所包含的实例数据,但是从 `to_vec` 中返回的Vector需要拥有实例数据因此`to_vec` 需要在每个元素上调用 `clone`来逐个复制。因此,存储在切片中的类型必须实现 `Clone`
`Copy` trait 允许你通过只拷贝存储在栈上的位来复制值而不需要额外的代码。查阅第四章 [“只在栈上的数据:拷贝”][stack-only-data-copy] 的部分来获取有关 `Copy` 的更多信息。
`Copy`特征允许你通过只拷贝存储在栈上的数据来复制值(浅拷贝),而无需复制存储在堆上的底层数据。查阅第四章[通过Copy复制栈数据](../core/ownership.md#通过Copy复制栈数据) 的部分来获取有关 `Copy` 的更多信息。
`Copy` trait 并未定义任何方法来阻止编程人员重写这些方法或违反不需要执行额外代码的假设。尽管如此所有的编程人员可以假设复制copy一个值非常快。
实际上`Copy`特征并不阻止你在实现时使用了深拷贝,只是,我们不应该这么做,毕竟遵循一个语言的惯例是很重要的。当用户看到`Copy`时,潜意识就应该知道这是浅拷贝,复制一个值会非常快。
可以在类型内部全部实现 `Copy` trait 的任意类型上派生 `Copy`。 但只可以在那些同时实现了 `Clone` 的类型上使用 `Copy` trait ,因为一个实现了 `Copy` 的类型也简单地实现了 `Clone`,其执行和 `Copy` 相同的任务
当一个类型的内部字段全部实现了`Copy`时,你就可以在该类型上派上`Copy`特征。 一个类型如果要实现`Copy`它必须先实现`Clone`,因为一个类型实现`Clone`后,就等于顺便实现了`Copy`
`Copy` trait 很少使用;实现 `Copy` 的类型是可以优化的,这意味着你无需调用 `clone`,这让代码更简洁
总之,`Copy`拥有更好的性能,当浅拷贝足够的时候,就不要使用`Clone`,不然会导致你的代码运行更慢,对于[性能优化](../performance/intro.md)来说,一个很大的方面就是减少热点路径深拷贝的发生
任何使用 `Copy` 的代码都可以通过 `Clone` 实现,但代码可能会稍慢,或者不得不在代码中的许多位置上使用 `clone`
### `Hash`用于实现值映射内存存储
### 固定大小的值到值映射的 `Hash`
`Hash` trait 可以实例化一个任意大小的类型并且能够用哈希hash函数将该实例映射到一个固定大小的值上。派生 `Hash` 实现了 `hash` 方法。`hash` 方法的派生实现结合了在类型的每部分调用 `hash` 的结果,这意味着所有的字段或值也必须实现了 `Hash`,这样才能够派生 `Hash`
`Hash`特征允许你使用`hash`函数把一个任意大小的实例映射到一个固定大小的值上。派生 `Hash` 实现了 `hash` 方法,对某个类型进行`hash`调用,其实就是对该类型下每个字段单独进行`hash`调用,然后把结果进行汇总,这意味着该类型下的所有的字段也必须实现了 `Hash`,这样才能够派生 `Hash`
例如,在 `HashMap<K, V>` 上存储数据,存放 key 的时候,`Hash` 是必须的。
### 默认值的 `Default`
`Default` trait 使你创建一个类型的默认值。 派生 `Default` 实现了 `default` 函数。`default` 函数的派生实现调用了类型每部分的 `default` 函数,这意味着类型中所有的字段或值也必须实现了 `Default`,这样才能够派生 `Default`
### `Default`用于获取默认值
`Default::default` 函数通常结合结构体更新语法一起使用,这在第五章的 [“使用结构体更新语法从其他实例中创建实例”][creating-instances-from-other-instances-with-struct-update-syntax] 部分有讨论。可以自定义一个结构体的一小部分字段而剩余字段则使用 `..Default::default()` 设置为默认值
`Default`特征会帮你创建一个类型的默认值。 派生`Default`意味着自动实现了 `default` 函数。`default` 函数的派生实现调用了类型每部分的 `default` 函数,这意味着类型中所有的字段也必须实现了 `Default`,这样才能够派生 `Default`
例如,当你在 `Option<T>` 实例上使用 `unwrap_or_default` 方法时,`Default` trait是必须的。如果 `Option<T>``None`的话, `unwrap_or_default` 方法将返回存储在 `Option<T>``T` 类型的 `Default::default` 的结果
`Default::default` 函数通常结合结构体更新语法一起使用,这在第五章的 [结构体更新语法](../basic/compound-type/struct.md#结构体更新语法) 部分有讨论。可以自定义一个结构体的一小部分字段而剩余字段则使用 `..Default::default()` 设置为默认值
[creating-instances-from-other-instances-with-struct-update-syntax]:
ch05-01-defining-structs.html#creating-instances-from-other-instances-with-struct-update-syntax
[stack-only-data-copy]:
ch04-01-what-is-ownership.html#stack-only-data-copy
[ways-variables-and-data-interact-clone]:
ch04-01-what-is-ownership.html#ways-variables-and-data-interact-clone
[macros]: ch19-06-macros.html#macros
例如,当你在 `Option<T>` 实例上使用 `unwrap_or_default` 方法时,`Default`特征是必须的。如果 `Option<T>``None`的话, `unwrap_or_default` 方法将返回`T` 类型的 `Default::default` 的结果。

@ -16,9 +16,9 @@
*Cargo.toml* 中的 `edition` 字段表明代码应该使用哪个版本编译。如果该字段不存在,其默认为 `2021` 以提供后向兼容性。
每个项目都可以选择不同于默认的 2021 edition 的版本。这样,版本可能会包含不兼容的修改,比如新增关键字可能会与代码中的标识符冲突并导致错误。不过除非选择兼容这些修改,(旧)代码仍将能够编译,即便升级了 Rust 编译器的版本。
每个项目都可以选择不同于默认的 2021 edition 的版本。这样,版本可能会包含不兼容的修改,比如新版本中新关键字可能会与代码中的标识符冲突并导致错误。不过,除非你选择应用这些修改,否则旧代码依然能够被便衣,即便你升级了编译器版本。
所有 Rust 编译器都支持任何之前存在的编译器版本,并可以链接任何支持版本的 crate。编译器修改只影响最初的解析代码的过程。因此,如果你使用 Rust 2021 而某个依赖使用 Rust 2018你的项目仍旧能够编译并使用该依赖。反之若项目使用 Rust 2018 而依赖使用 Rust 2021 亦可工作。
所有 Rust 编译器都支持任何之前存在的编译器版本,并可以链接任何支持版本的。编译器修改只影响最初的解析代码的过程。因此,如果你使用 Rust 2021 而某个依赖使用 Rust 2018你的项目仍旧能够编译并使用该依赖。反之若项目使用 Rust 2018 而依赖使用 Rust 2021 亦可工作。
有一点需要明确:大部分功能在所有版本中都能使用。开发者使用任何 Rust 版本将能继续接收最新稳定版的改进。然而在一些情况,主要是增加了新关键字的时候,则可能出现了只能用于新版本的功能。只需切换版本即可利用新版本的功能。

@ -1 +0,0 @@
# struct-enum.md

@ -0,0 +1 @@
# 复合类型(todo)

@ -0,0 +1,3 @@
# Struct(todo)
## 结构体更新语法

@ -1 +1,8 @@
# 所有权
## 通过Clone来进行深拷贝
## 通过Copy复制栈数据
Loading…
Cancel
Save