diff --git a/docs/ch10-01-syntax.html b/docs/ch10-01-syntax.html
index be2aaec..695cd77 100644
--- a/docs/ch10-01-syntax.html
+++ b/docs/ch10-01-syntax.html
@@ -246,7 +246,108 @@ values of different types
现在所有这些Point
实例都是被允许的了!你可以在定义中使用任意多的泛型类型参数,不过太多的话代码将难以阅读和理解。如果你处于一个需要很多泛型类型的位置,这可能是一个需要重新组织代码并分隔成一些更小部分的信号。
-类似于结构体,枚举也可以在其成员中存放泛型数据类型。
+类似于结构体,枚举也可以在其成员中存放泛型数据类型。第六章我们使用过了标准库提供的Option<T>
枚举,现在这个定义看起来就更容易理解了。让我们再看看:
+enum Option<T> {
+ Some(T),
+ None,
+}
+
+换句话说Option<T>
是一个拥有泛型T
的枚举。它有两个成员:Some
,它存放了一个类型T
的值,和不存在任何值的None
。标准库中只有这一个定义来支持创建任何具体类型的枚举值。“一个可能的值”是一个比具体类型的值更抽象的概念,而 Rust 允许我们不引入重复就能表现抽象的概念。
+枚举也可以拥有多个泛型类型。第九章使用过的Result
枚举定义就是一个这样的例子:
+enum Result<T, E> {
+ Ok(T),
+ Err(E),
+}
+
+Result
枚举有两个泛型类型,T
和E
。Result
有两个成员:Ok
,它存放一个类型T
的值,而Err
则存放一个类型E
的值。这个定义使得Result
枚举能很方便的表达任何可能成功(返回T
类型的值)也可能失败(返回E
类型的值)的操作。回忆一下列表 9-2 中打开一个文件的场景,当文件被成功打开T
被放入了std::fs::File
类型而当打开文件出现问题时E
被放入了std::io::Error
类型。
+当发现代码中有多个只有存放的值的类型有所不同的结构体或枚举定义时,你就应该像之前的函数定义中那样引入泛型类型来减少重复。
+
+可以像第五章介绍的那样来为其定义中带有泛型的结构体或枚举实现方法。列表 10-9 中展示了列表 10-6 中定义的结构体Point<T>
。接着我们在Point<T>
上定义了一个叫做x
的方法来返回字段x
中数据的引用:
+
+注意必须在impl
后面声明T
,这样就可以在Point<T>
上实现的方法中使用它了。
+结构体定义中的泛型类型参数并不总是与结构体方法签名中使用的泛型是同一类型。列表 10-10 中在列表 10-8 中的结构体Point<T, U>
上定义了一个方法mixup
。这个方法获取另一个Point
作为参数,而它可能与调用mixup
的self
是不同的Point
类型。这个方法用self
的Point
类型的x
值(类型T
)和参数的Point
类型的y
值(类型W
)来创建一个新Point
类型的实例:
+
+在main
函数中,定义了一个有i32
类型的x
(其值为5
)和f64
的y
(其值为10.4
)的Point
。p2
则是一个有着字符串 slice 类型的x
(其值为"Hello"
)和char
类型的y
(其值为c
)的Point
。在p1
上以p2
调用mixup
会返回一个p3
,它会有一个i32
类型的x
,因为x
来自p1
,并拥有一个char
类型的y
,因为y
来自p2
。println!
会打印出p3.x = 5, p3.y = c
。
+注意泛型参数T
和U
声明于impl
之后,因为他们于结构体定义相对应。而泛型参数V
和W
声明于fn mixup
之后,因为他们只是相对于方法本身的。
+
+在阅读本部分的内容的同时你可能会好奇使用泛型类型参数是否会有运行时消耗。好消息是:Rust 实现泛型泛型的方式意味着你的代码使用泛型类型参数相比指定具体类型并没有任何速度上的损失。
+Rust 通过在编译时进行泛型代码的单态化(monomorphization)来保证效率。单态化是一个将泛型代码转变为实际放入的具体类型的特定代码的过程。
+编译器所做的工作正好与列表 10-5 中我们创建泛型函数的步骤相反。编译器寻找所有泛型代码被调用的位置并使用泛型代码针对具体类型生成代码。
+让我们看看一个使用标准库中Option
枚举的例子:
+let integer = Some(5);
+let float = Some(5.0);
+
+当 Rust 编译这些代码的时候,它会进行单态化。编译器会读取传递给Option
的值并发现有两种Option<T>
:一个对应i32
另一个对应f64
。为此,它会将泛型定义Option<T>
展开为Option_i32
和Option_f64
,接着将泛型定义替换为这两个具体的定义。
+编译器生成的单态化版本的代码看起来像这样,并包含将泛型Option
替换为编译器创建的具体定义后的用例代码:
+Filename: src/main.rs
+enum Option_i32 {
+ Some(i32),
+ None,
+}
+
+enum Option_f64 {
+ Some(f64),
+ None,
+}
+
+fn main() {
+ let integer = Option_i32::Some(5);
+ let float = Option_f64::Some(5.0);
+}
+
+我们可以使用泛型来编写不重复的代码,而 Rust 会将会为每一个实例编译其特定类型的代码。这意味着在使用泛型时没有运行时开销;当代码运行,它的执行效率就跟好像手写每个具体定义的重复代码一样。这个单态化过程正是 Rust 泛型在运行时极其高效的原因。
diff --git a/docs/ch10-02-traits.html b/docs/ch10-02-traits.html
index e076d46..d0d6eec 100644
--- a/docs/ch10-02-traits.html
+++ b/docs/ch10-02-traits.html
@@ -67,7 +67,74 @@
-
+
+
+ch10-02-traits.md
+
+commit 709eb1eaca48864fafd9263042f5f9d9d6ffe08d
+
+
trait 允许我们进行另一种抽象:他们让我们可以抽象类型所通用的行为。trait 告诉 Rust 编译器某个特定类型拥有可能与其他类型共享的功能。在使用泛型类型参数的场景中,可以使用 trait bounds 在编译时指定泛型可以是任何实现了某个 trait 的类型,并由此在这个场景下拥有我们希望的功能。
+
+注意:trait 类似于其他语言中的常被称为接口(interfaces)的功能,虽然有一些不同。
+
+
+
一个类型的行为由其可供调用的方法构成。如果可以对不同类型调用相同的方法的话,这些类型就可以共享相同的行为了。trait 定义是一种将方法签名组合起来的方法,目的是定义一个实现某些目的所必须行为的集合。
+
例如,这里有多个存放了不同类型和属性文本的结构体:结构体NewsArticle
用于存放发生于世界各地的新闻故事,而结构体Tweet
最多只能存放 140 个字符的内容,以及像是否转推或是否是对推友的回复这样的元数据。
+
我们想要创建一个多媒体聚合库用来显示可能储存在NewsArticle
或Tweet
实例中的数据的总结。每一个结构体都需要的行为是他们是能够被总结的,这样的话就可以调用实例的summary
方法来请求总结。列表 10-11 中展示了一个表现这个概念的Summarizable
trait 的定义:
+
+
使用trait
关键字来定义一个 trait,后面是 trait 的名字,在这个例子中是Summarizable
。在大括号中声明描述实现这个 trait 的类型所需要的行为的方法签名,在这个例子中是是fn summary(&self) -> String
。在方法签名后跟分号而不是在大括号中提供其实现。接着每一个实现这个 trait 的类型都需要提供其自定义行为的方法体,编译器也会确保任何实现Summarizable
trait 的类型都拥有与这个签名的定义完全一致的summary
方法。
+
trait 体中可以有多个方法,一行一个方法签名且都以分号结尾。
+
+
现在我们定义了Summarizable
trait,接着就可以在多媒体聚合库中需要拥有这个行为的类型上实现它了。列表 10-12 中展示了NewsArticle
结构体上Summarizable
trait 的一个实现,它使用标题、作者和创建的位置作为summary
的返回值。对于Tweet
结构体,我们选择将summary
定义为用户名后跟推文的全部文本作为返回值,并假设推文内容已经被限制为 140 字符以内。
+
+
在类型上实现 trait 类似与实现与 trait 无关的方法。区别在于impl
关键字之后,我们提供需要实现 trait 的名称,接着是for
和需要实现 trait 的类型的名称。
+
diff --git a/docs/print.html b/docs/print.html
index d243128..6d1d60a 100644
--- a/docs/print.html
+++ b/docs/print.html
@@ -4820,7 +4820,175 @@ values of different types
现在所有这些Point
实例都是被允许的了!你可以在定义中使用任意多的泛型类型参数,不过太多的话代码将难以阅读和理解。如果你处于一个需要很多泛型类型的位置,这可能是一个需要重新组织代码并分隔成一些更小部分的信号。
-类似于结构体,枚举也可以在其成员中存放泛型数据类型。
+类似于结构体,枚举也可以在其成员中存放泛型数据类型。第六章我们使用过了标准库提供的Option<T>
枚举,现在这个定义看起来就更容易理解了。让我们再看看:
+enum Option<T> {
+ Some(T),
+ None,
+}
+
+换句话说Option<T>
是一个拥有泛型T
的枚举。它有两个成员:Some
,它存放了一个类型T
的值,和不存在任何值的None
。标准库中只有这一个定义来支持创建任何具体类型的枚举值。“一个可能的值”是一个比具体类型的值更抽象的概念,而 Rust 允许我们不引入重复就能表现抽象的概念。
+枚举也可以拥有多个泛型类型。第九章使用过的Result
枚举定义就是一个这样的例子:
+enum Result<T, E> {
+ Ok(T),
+ Err(E),
+}
+
+Result
枚举有两个泛型类型,T
和E
。Result
有两个成员:Ok
,它存放一个类型T
的值,而Err
则存放一个类型E
的值。这个定义使得Result
枚举能很方便的表达任何可能成功(返回T
类型的值)也可能失败(返回E
类型的值)的操作。回忆一下列表 9-2 中打开一个文件的场景,当文件被成功打开T
被放入了std::fs::File
类型而当打开文件出现问题时E
被放入了std::io::Error
类型。
+当发现代码中有多个只有存放的值的类型有所不同的结构体或枚举定义时,你就应该像之前的函数定义中那样引入泛型类型来减少重复。
+
+可以像第五章介绍的那样来为其定义中带有泛型的结构体或枚举实现方法。列表 10-9 中展示了列表 10-6 中定义的结构体Point<T>
。接着我们在Point<T>
上定义了一个叫做x
的方法来返回字段x
中数据的引用:
+
+注意必须在impl
后面声明T
,这样就可以在Point<T>
上实现的方法中使用它了。
+结构体定义中的泛型类型参数并不总是与结构体方法签名中使用的泛型是同一类型。列表 10-10 中在列表 10-8 中的结构体Point<T, U>
上定义了一个方法mixup
。这个方法获取另一个Point
作为参数,而它可能与调用mixup
的self
是不同的Point
类型。这个方法用self
的Point
类型的x
值(类型T
)和参数的Point
类型的y
值(类型W
)来创建一个新Point
类型的实例:
+
+在main
函数中,定义了一个有i32
类型的x
(其值为5
)和f64
的y
(其值为10.4
)的Point
。p2
则是一个有着字符串 slice 类型的x
(其值为"Hello"
)和char
类型的y
(其值为c
)的Point
。在p1
上以p2
调用mixup
会返回一个p3
,它会有一个i32
类型的x
,因为x
来自p1
,并拥有一个char
类型的y
,因为y
来自p2
。println!
会打印出p3.x = 5, p3.y = c
。
+注意泛型参数T
和U
声明于impl
之后,因为他们于结构体定义相对应。而泛型参数V
和W
声明于fn mixup
之后,因为他们只是相对于方法本身的。
+
+在阅读本部分的内容的同时你可能会好奇使用泛型类型参数是否会有运行时消耗。好消息是:Rust 实现泛型泛型的方式意味着你的代码使用泛型类型参数相比指定具体类型并没有任何速度上的损失。
+Rust 通过在编译时进行泛型代码的单态化(monomorphization)来保证效率。单态化是一个将泛型代码转变为实际放入的具体类型的特定代码的过程。
+编译器所做的工作正好与列表 10-5 中我们创建泛型函数的步骤相反。编译器寻找所有泛型代码被调用的位置并使用泛型代码针对具体类型生成代码。
+让我们看看一个使用标准库中Option
枚举的例子:
+let integer = Some(5);
+let float = Some(5.0);
+
+当 Rust 编译这些代码的时候,它会进行单态化。编译器会读取传递给Option
的值并发现有两种Option<T>
:一个对应i32
另一个对应f64
。为此,它会将泛型定义Option<T>
展开为Option_i32
和Option_f64
,接着将泛型定义替换为这两个具体的定义。
+编译器生成的单态化版本的代码看起来像这样,并包含将泛型Option
替换为编译器创建的具体定义后的用例代码:
+Filename: src/main.rs
+enum Option_i32 {
+ Some(i32),
+ None,
+}
+
+enum Option_f64 {
+ Some(f64),
+ None,
+}
+
+fn main() {
+ let integer = Option_i32::Some(5);
+ let float = Option_f64::Some(5.0);
+}
+
+我们可以使用泛型来编写不重复的代码,而 Rust 会将会为每一个实例编译其特定类型的代码。这意味着在使用泛型时没有运行时开销;当代码运行,它的执行效率就跟好像手写每个具体定义的重复代码一样。这个单态化过程正是 Rust 泛型在运行时极其高效的原因。
+
+
+ch10-02-traits.md
+
+commit 709eb1eaca48864fafd9263042f5f9d9d6ffe08d
+
+trait 允许我们进行另一种抽象:他们让我们可以抽象类型所通用的行为。trait 告诉 Rust 编译器某个特定类型拥有可能与其他类型共享的功能。在使用泛型类型参数的场景中,可以使用 trait bounds 在编译时指定泛型可以是任何实现了某个 trait 的类型,并由此在这个场景下拥有我们希望的功能。
+
+注意:trait 类似于其他语言中的常被称为接口(interfaces)的功能,虽然有一些不同。
+
+
+一个类型的行为由其可供调用的方法构成。如果可以对不同类型调用相同的方法的话,这些类型就可以共享相同的行为了。trait 定义是一种将方法签名组合起来的方法,目的是定义一个实现某些目的所必须行为的集合。
+例如,这里有多个存放了不同类型和属性文本的结构体:结构体NewsArticle
用于存放发生于世界各地的新闻故事,而结构体Tweet
最多只能存放 140 个字符的内容,以及像是否转推或是否是对推友的回复这样的元数据。
+我们想要创建一个多媒体聚合库用来显示可能储存在NewsArticle
或Tweet
实例中的数据的总结。每一个结构体都需要的行为是他们是能够被总结的,这样的话就可以调用实例的summary
方法来请求总结。列表 10-11 中展示了一个表现这个概念的Summarizable
trait 的定义:
+
+使用trait
关键字来定义一个 trait,后面是 trait 的名字,在这个例子中是Summarizable
。在大括号中声明描述实现这个 trait 的类型所需要的行为的方法签名,在这个例子中是是fn summary(&self) -> String
。在方法签名后跟分号而不是在大括号中提供其实现。接着每一个实现这个 trait 的类型都需要提供其自定义行为的方法体,编译器也会确保任何实现Summarizable
trait 的类型都拥有与这个签名的定义完全一致的summary
方法。
+trait 体中可以有多个方法,一行一个方法签名且都以分号结尾。
+
+现在我们定义了Summarizable
trait,接着就可以在多媒体聚合库中需要拥有这个行为的类型上实现它了。列表 10-12 中展示了NewsArticle
结构体上Summarizable
trait 的一个实现,它使用标题、作者和创建的位置作为summary
的返回值。对于Tweet
结构体,我们选择将summary
定义为用户名后跟推文的全部文本作为返回值,并假设推文内容已经被限制为 140 字符以内。
+
+在类型上实现 trait 类似与实现与 trait 无关的方法。区别在于impl
关键字之后,我们提供需要实现 trait 的名称,接着是for
和需要实现 trait 的类型的名称。
diff --git a/src/ch10-01-syntax.md b/src/ch10-01-syntax.md
index 3277a29..4a58343 100644
--- a/src/ch10-01-syntax.md
+++ b/src/ch10-01-syntax.md
@@ -237,4 +237,145 @@ values of different types
### 枚举定义中的泛型数据类型
-类似于结构体,枚举也可以在其成员中存放泛型数据类型。
\ No newline at end of file
+类似于结构体,枚举也可以在其成员中存放泛型数据类型。第六章我们使用过了标准库提供的`Option`枚举,现在这个定义看起来就更容易理解了。让我们再看看:
+
+```rust
+enum Option {
+ Some(T),
+ None,
+}
+```
+
+换句话说`Option`是一个拥有泛型`T`的枚举。它有两个成员:`Some`,它存放了一个类型`T`的值,和不存在任何值的`None`。标准库中只有这一个定义来支持创建任何具体类型的枚举值。“一个可能的值”是一个比具体类型的值更抽象的概念,而 Rust 允许我们不引入重复就能表现抽象的概念。
+
+枚举也可以拥有多个泛型类型。第九章使用过的`Result`枚举定义就是一个这样的例子:
+
+```rust
+enum Result {
+ Ok(T),
+ Err(E),
+}
+```
+
+`Result`枚举有两个泛型类型,`T`和`E`。`Result`有两个成员:`Ok`,它存放一个类型`T`的值,而`Err`则存放一个类型`E`的值。这个定义使得`Result`枚举能很方便的表达任何可能成功(返回`T`类型的值)也可能失败(返回`E`类型的值)的操作。回忆一下列表 9-2 中打开一个文件的场景,当文件被成功打开`T`被放入了`std::fs::File`类型而当打开文件出现问题时`E`被放入了`std::io::Error`类型。
+
+当发现代码中有多个只有存放的值的类型有所不同的结构体或枚举定义时,你就应该像之前的函数定义中那样引入泛型类型来减少重复。
+
+### 方法定义中的枚举数据类型
+
+可以像第五章介绍的那样来为其定义中带有泛型的结构体或枚举实现方法。列表 10-9 中展示了列表 10-6 中定义的结构体`Point`。接着我们在`Point`上定义了一个叫做`x`的方法来返回字段`x`中数据的引用:
+
+
+
+注意必须在`impl`后面声明`T`,这样就可以在`Point`上实现的方法中使用它了。
+
+结构体定义中的泛型类型参数并不总是与结构体方法签名中使用的泛型是同一类型。列表 10-10 中在列表 10-8 中的结构体`Point`上定义了一个方法`mixup`。这个方法获取另一个`Point`作为参数,而它可能与调用`mixup`的`self`是不同的`Point`类型。这个方法用`self`的`Point`类型的`x`值(类型`T`)和参数的`Point`类型的`y`值(类型`W`)来创建一个新`Point`类型的实例:
+
+
+
+在`main`函数中,定义了一个有`i32`类型的`x`(其值为`5`)和`f64`的`y`(其值为`10.4`)的`Point`。`p2`则是一个有着字符串 slice 类型的`x`(其值为`"Hello"`)和`char`类型的`y`(其值为`c`)的`Point`。在`p1`上以`p2`调用`mixup`会返回一个`p3`,它会有一个`i32`类型的`x`,因为`x`来自`p1`,并拥有一个`char`类型的`y`,因为`y`来自`p2`。`println!`会打印出`p3.x = 5, p3.y = c`。
+
+注意泛型参数`T`和`U`声明于`impl`之后,因为他们于结构体定义相对应。而泛型参数`V`和`W`声明于`fn mixup`之后,因为他们只是相对于方法本身的。
+
+### 泛型代码的性能
+
+在阅读本部分的内容的同时你可能会好奇使用泛型类型参数是否会有运行时消耗。好消息是:Rust 实现泛型泛型的方式意味着你的代码使用泛型类型参数相比指定具体类型并没有任何速度上的损失。
+
+Rust 通过在编译时进行泛型代码的**单态化**(*monomorphization*)来保证效率。单态化是一个将泛型代码转变为实际放入的具体类型的特定代码的过程。
+
+编译器所做的工作正好与列表 10-5 中我们创建泛型函数的步骤相反。编译器寻找所有泛型代码被调用的位置并使用泛型代码针对具体类型生成代码。
+
+让我们看看一个使用标准库中`Option`枚举的例子:
+
+```rust
+let integer = Some(5);
+let float = Some(5.0);
+```
+
+当 Rust 编译这些代码的时候,它会进行单态化。编译器会读取传递给`Option`的值并发现有两种`Option`:一个对应`i32`另一个对应`f64`。为此,它会将泛型定义`Option`展开为`Option_i32`和`Option_f64`,接着将泛型定义替换为这两个具体的定义。
+
+编译器生成的单态化版本的代码看起来像这样,并包含将泛型`Option`替换为编译器创建的具体定义后的用例代码:
+
+
+Filename: src/main.rs
+
+```rust
+enum Option_i32 {
+ Some(i32),
+ None,
+}
+
+enum Option_f64 {
+ Some(f64),
+ None,
+}
+
+fn main() {
+ let integer = Option_i32::Some(5);
+ let float = Option_f64::Some(5.0);
+}
+```
+
+我们可以使用泛型来编写不重复的代码,而 Rust 会将会为每一个实例编译其特定类型的代码。这意味着在使用泛型时没有运行时开销;当代码运行,它的执行效率就跟好像手写每个具体定义的重复代码一样。这个单态化过程正是 Rust 泛型在运行时极其高效的原因。
\ No newline at end of file
diff --git a/src/ch10-02-traits.md b/src/ch10-02-traits.md
index e69de29..7514e42 100644
--- a/src/ch10-02-traits.md
+++ b/src/ch10-02-traits.md
@@ -0,0 +1,87 @@
+## trait:定义共享的行为
+
+> [ch10-02-traits.md](https://github.com/rust-lang/book/blob/master/src/ch10-02-traits.md)
+>
+> commit 709eb1eaca48864fafd9263042f5f9d9d6ffe08d
+
+trait 允许我们进行另一种抽象:他们让我们可以抽象类型所通用的行为。*trait* 告诉 Rust 编译器某个特定类型拥有可能与其他类型共享的功能。在使用泛型类型参数的场景中,可以使用 *trait bounds* 在编译时指定泛型可以是任何实现了某个 trait 的类型,并由此在这个场景下拥有我们希望的功能。
+
+> 注意:*trait* 类似于其他语言中的常被称为**接口**(*interfaces*)的功能,虽然有一些不同。
+
+### 定义 trait
+
+一个类型的行为由其可供调用的方法构成。如果可以对不同类型调用相同的方法的话,这些类型就可以共享相同的行为了。trait 定义是一种将方法签名组合起来的方法,目的是定义一个实现某些目的所必须行为的集合。
+
+例如,这里有多个存放了不同类型和属性文本的结构体:结构体`NewsArticle`用于存放发生于世界各地的新闻故事,而结构体`Tweet`最多只能存放 140 个字符的内容,以及像是否转推或是否是对推友的回复这样的元数据。
+
+我们想要创建一个多媒体聚合库用来显示可能储存在`NewsArticle`或`Tweet`实例中的数据的总结。每一个结构体都需要的行为是他们是能够被总结的,这样的话就可以调用实例的`summary`方法来请求总结。列表 10-11 中展示了一个表现这个概念的`Summarizable` trait 的定义:
+
+
+
+使用`trait`关键字来定义一个 trait,后面是 trait 的名字,在这个例子中是`Summarizable`。在大括号中声明描述实现这个 trait 的类型所需要的行为的方法签名,在这个例子中是是`fn summary(&self) -> String`。在方法签名后跟分号而不是在大括号中提供其实现。接着每一个实现这个 trait 的类型都需要提供其自定义行为的方法体,编译器也会确保任何实现`Summarizable` trait 的类型都拥有与这个签名的定义完全一致的`summary`方法。
+
+trait 体中可以有多个方法,一行一个方法签名且都以分号结尾。
+
+### 为类型实现 trait
+
+现在我们定义了`Summarizable` trait,接着就可以在多媒体聚合库中需要拥有这个行为的类型上实现它了。列表 10-12 中展示了`NewsArticle`结构体上`Summarizable` trait 的一个实现,它使用标题、作者和创建的位置作为`summary`的返回值。对于`Tweet`结构体,我们选择将`summary`定义为用户名后跟推文的全部文本作为返回值,并假设推文内容已经被限制为 140 字符以内。
+
+
+
+在类型上实现 trait 类似与实现与 trait 无关的方法。区别在于`impl`关键字之后,我们提供需要实现 trait 的名称,接着是`for`和需要实现 trait 的类型的名称。
\ No newline at end of file