diff --git a/docs/ch15-02-deref.html b/docs/ch15-02-deref.html index 09ced3d..388b435 100644 --- a/docs/ch15-02-deref.html +++ b/docs/ch15-02-deref.html @@ -84,7 +84,70 @@ commit 3f2a1bd8dbb19cc48b210fc4fb35c305c8d81b56

assert_eq!(6, x); -

我们使用*y来访问可变引用y所指向的数据，

+

我们使用*y来访问可变引用y所指向的数据，而是可变引用本身。接着可以修改它的数据，在这里对其加一。

+

引用并不是智能指针，他们只是引用指向的一个值，所以这个解引用操作是很直接的。智能指针还会储存指针或数据的元数据。当解引用一个智能指针时，我们只想要数据，而不需要元数据。我们希望能在使用常规引用的地方也能使用智能指针。为此，可以通过实现Deref trait 来重载*运算符的行为。

+

列表 15-7 展示了一个定义为储存 mp3 数据和元数据的结构体通过Deref trait 来重载*的例子。Mp3，在某种意义上是一个智能指针：它拥有包含音频的Vec<u8>数据。另外，它储存了一些可选的元数据，在这个例子中是音频数据中艺术家和歌曲的名称。我们希望能够方便的访问音频数据而不是元数据，所以需要实现Deref trait 来返回音频数据。实现Deref trait 需要一个叫做deref的方法，它借用self并返回其内部数据：

+

Filename: src/main.rs

+
use std::ops::Deref;
+
+struct Mp3 {
+    audio: Vec<u8>,
+    artist: Option<String>,
+    title: Option<String>,
+}
+
+impl Deref for Mp3 {
+    type Target = Vec<u8>;
+
+    fn deref(&self) -> &Vec<u8> {
+        &self.audio
+    }
+}
+
+fn main() {
+    let my_favorite_song = Mp3 {
+        // we would read the actual audio data from an mp3 file
+        audio: vec![1, 2, 3],
+        artist: Some(String::from("Nirvana")),
+        title: Some(String::from("Smells Like Teen Spirit")),
+    };
+
+    assert_eq!(vec![1, 2, 3], *my_favorite_song);
+}
+
+

Listing 15-7: An implementation of the Deref trait on a +struct that holds mp3 file data and metadata

+

大部分代码看起来都比较熟悉：一个结构体、一个 trait 实现、和一个创建了结构体示例的 main 函数。其中有一部分我们还未全面的讲解：类似于第十三章学习迭代器 trait 时出现的type Item，type Target = T;语法用于定义关联类型，第十九章会更详细的介绍。不必过分担心例子中的这一部分；它只是一个稍显不同的定义泛型参数的方式。

+

在assert_eq!中，我们验证vec![1, 2, 3]是否为Mp3实例*my_favorite_song解引用的值，结果正是如此因为我们实现了deref方法来返回音频数据。如果没有为Mp3实现Deref trait，Rust 将不会编译*my_favorite_song：会出现错误说Mp3类型不能被解引用。

+

代码能够工作的原因在于调用*my_favorite_song时*在背后所做的操作：

+
*(my_favorite_song.deref())
+
+

这对my_favorite_song调用了deref方法，它借用了my_favorite_song并返回指向my_favorite_song.audio的引用，这正是列表 15-5 中deref所定义的。引用的*被定义为仅仅从引用中返回其数据，所以上面*的展开形式对于外部*来说并不是递归的。最终的数据类型是Vec<u8>，它与列表 15-5 中assert_eq!的vec![1, 2, 3]相匹配。

+

deref方法的返回值类型仍然是引用和为何必须解引用方法的结果的原因是如果deref方法就返回值，使用*总是会获取其所有权。

+

函数和方法的隐式解引用强制多态

 +

Rust 倾向于偏爱明确而不是隐晦，不过一个情况下这并不成立，就是函数和方法的参数的解引用强制多态（deref coercions）。解引用强制多态会自动的将指针或智能指针的引用转换为指针内容的引用。解引用强制多态发生于一个值被传递给函数或方法，并只发生于需要将传递的值类型与签名中参数类型相匹配的时候。解引用强制多态的加入使得 Rust 调用函数或方法时无需很多使用&和*的引用和解引用。

+

使用列表 15-5 中的Mp3结构体，如下是一个获取u8 slice 并压缩 mp3 音频数据的函数签名：

+
fn compress_mp3(audio: &[u8]) -> Vec<u8> {
+    // the actual implementation would go here
+}
+
+

如果 Rust 没有解引用强制多态，为了使用my_favorite_song中的音频数据调用此函数，必须写成：

+
compress_mp3(my_favorite_song.audio.as_slice())
+
+

也就是说，必须明确表用需要my_favorite_song中的audio字段而且我们希望有一个 slice 来引用这整个Vec<u8>。如果有很多地方需要用相同的方式处理audio数据，那么.audio.as_slice()就显得冗长重复了。

+

然而，因为解引用强制多态和Mp3的Deref trait 实现，我们可以使用如下代码使用my_favorite_song中的数据调用这个函数：

+
let result = compress_mp3(&my_favorite_song);
+
+

只有&和实例，好的！我们可以把智能指针当成普通的引用。也就是说解引用强制多态意味着 Rust 利用了Deref实现的优势：Rust 知道Mp3实现了Deref trait 并从deref方法返回&Vec<u8>。它也知道标准库实现了Vec<T>的Deref trait，其deref方法返回&[T]（我们也可以通过查阅Vec<T>的 API 文档来发现这一点）。所以，在编译时，Rust 会发现它可以调用两次Deref::deref来将&Mp3变成&Vec<u8>再变成&[T]来满足compress_mp3的签名。这意味着我们可以少写一些代码！Rust 会多次分析Deref::deref的返回值类型直到它满足参数的类型，只要相关类型实现了Deref trait。这些间接转换在编译时进行，所以利用解引用强制多态并没有运行时惩罚。

+

这里还有一个重载了&mut T的*的DerefMut trait，它以与Deref重载&T的*相同的方式用于参数中。

+

Rust 在发现类型和 trait 实现满足三种情况时会进行解引用强制多态：

+ +

头两个情况除了可变性之外是相同的：如果有一个&T，而T实现了返回U类型的Deref，可以直接得到&U。对于可变引用也是一样。最后一个有些微妙：如果有一个可变引用，它也可以强转为一个不可变引用。反之则是_不可能_的：不可变引用永远也不能强转为可变引用。

+

Deref trait 对于只能指针模式十分重要的原因在于智能指针可以被看作普通引用并用于期望使用引用的地方。例如，无需重新编写方法和函数来直接获取智能指针。

diff --git a/docs/ch15-03-drop.html b/docs/ch15-03-drop.html index fe15cc2..aecad1f 100644 --- a/docs/ch15-03-drop.html +++ b/docs/ch15-03-drop.html @@ -67,7 +67,43 @@
- +

Drop Trait 运行清理代码

 +
+

ch15-03-drop.md +
+commit 3f2a1bd8dbb19cc48b210fc4fb35c305c8d81b56

+
+

对于智能指针模式来说另一个重要的 trait 是Drop。Drop运行我们在值要离开作用域时执行一些代码。智能指针在被丢弃时会执行一些重要的清理工作，比如释放内存或减少引用计数。更一般的来讲，数据类型可以管理多于内存的资源，比如文件或网络连接，而使用Drop在代码处理完他们之后释放这些资源。我们在智能指针上下文中讨论Drop是因为其功能几乎总是用于实现智能指针。

+

在其他一些语言中，必须每次总是必须记住在使用完智能指针实例后调用清理内存或资源的代码。如果忘记的话，运行代码的系统可能会因为负荷过重而崩溃。在 Rust 中，可以指定一些代码应该在值离开作用域时被执行，而编译器会自动插入这些代码。这意味着无需记住在所有处理完这些类型实例后调用清理代码，而仍然不会泄露资源！

+

指定在值离开作用域时应该执行的代码的方式是实现Drop trait。Drop trait 要求我们实现一个叫做drop的方法，它获取一个self的可变引用。

+

列表 15-8 展示了并没有实际功能的结构体CustomSmartPointer，不过我们会在创建实例之后打印出CustomSmartPointer created.，而在实例离开作用域时打印出Dropping CustomSmartPointer!，这样就能看出哪些代码被执行了。不同于println!语句，我们在智能指针需要执行清理代码时使用drop：

+

Filename: src/main.rs

+
struct CustomSmartPointer {
+    data: String,
+}
+
+impl Drop for CustomSmartPointer {
+    fn drop(&mut self) {
+        println!("Dropping CustomSmartPointer!");
+    }
+}
+
+fn main() {
+    let c = CustomSmartPointer { data: String::from("some data") };
+    println!("CustomSmartPointer created.");
+    println!("Wait for it...");
+}
+
+

Listing 15-8: A CustomSmartPointer struct that +implements the Drop trait, where we could put code that would clean up after +the CustomSmartPointer.

+

Drop trait 位于 prelude 中，所以无需导入它。drop方法的实现调用了println!；这里是你需要实际需要放入关闭套接字代码的地方。在main函数中，我们创建一个CustomSmartPointer的新实例并打印出CustomSmartPointer created.以便在运行时知道代码运行到此出。在main的结尾，CustomSmartPointer的实例会离开作用域。注意我们没有显式调用drop方法：

+

当运行这个程序，我们会看到：

+
CustomSmartPointer created.
+Wait for it...
+Dropping CustomSmartPointer!
+
+
diff --git a/docs/print.html b/docs/print.html index b3d634b..6c9fe9f 100644 --- a/docs/print.html +++ b/docs/print.html @@ -8291,7 +8291,106 @@ commit 3f2a1bd8dbb19cc48b210fc4fb35c305c8d81b56

assert_eq!(6, x); -

我们使用*y来访问可变引用y所指向的数据，

+

我们使用*y来访问可变引用y所指向的数据，而是可变引用本身。接着可以修改它的数据，在这里对其加一。

+

引用并不是智能指针，他们只是引用指向的一个值，所以这个解引用操作是很直接的。智能指针还会储存指针或数据的元数据。当解引用一个智能指针时，我们只想要数据，而不需要元数据。我们希望能在使用常规引用的地方也能使用智能指针。为此，可以通过实现Deref trait 来重载*运算符的行为。

+

列表 15-7 展示了一个定义为储存 mp3 数据和元数据的结构体通过Deref trait 来重载*的例子。Mp3，在某种意义上是一个智能指针：它拥有包含音频的Vec<u8>数据。另外，它储存了一些可选的元数据，在这个例子中是音频数据中艺术家和歌曲的名称。我们希望能够方便的访问音频数据而不是元数据，所以需要实现Deref trait 来返回音频数据。实现Deref trait 需要一个叫做deref的方法，它借用self并返回其内部数据：

+

Filename: src/main.rs

+
use std::ops::Deref;
+
+struct Mp3 {
+    audio: Vec<u8>,
+    artist: Option<String>,
+    title: Option<String>,
+}
+
+impl Deref for Mp3 {
+    type Target = Vec<u8>;
+
+    fn deref(&self) -> &Vec<u8> {
+        &self.audio
+    }
+}
+
+fn main() {
+    let my_favorite_song = Mp3 {
+        // we would read the actual audio data from an mp3 file
+        audio: vec![1, 2, 3],
+        artist: Some(String::from("Nirvana")),
+        title: Some(String::from("Smells Like Teen Spirit")),
+    };
+
+    assert_eq!(vec![1, 2, 3], *my_favorite_song);
+}
+
+

Listing 15-7: An implementation of the Deref trait on a +struct that holds mp3 file data and metadata

+

大部分代码看起来都比较熟悉：一个结构体、一个 trait 实现、和一个创建了结构体示例的 main 函数。其中有一部分我们还未全面的讲解：类似于第十三章学习迭代器 trait 时出现的type Item，type Target = T;语法用于定义关联类型，第十九章会更详细的介绍。不必过分担心例子中的这一部分；它只是一个稍显不同的定义泛型参数的方式。

+

在assert_eq!中，我们验证vec![1, 2, 3]是否为Mp3实例*my_favorite_song解引用的值，结果正是如此因为我们实现了deref方法来返回音频数据。如果没有为Mp3实现Deref trait，Rust 将不会编译*my_favorite_song：会出现错误说Mp3类型不能被解引用。

+

代码能够工作的原因在于调用*my_favorite_song时*在背后所做的操作：

+
*(my_favorite_song.deref())
+
+

这对my_favorite_song调用了deref方法，它借用了my_favorite_song并返回指向my_favorite_song.audio的引用，这正是列表 15-5 中deref所定义的。引用的*被定义为仅仅从引用中返回其数据，所以上面*的展开形式对于外部*来说并不是递归的。最终的数据类型是Vec<u8>，它与列表 15-5 中assert_eq!的vec![1, 2, 3]相匹配。

+

deref方法的返回值类型仍然是引用和为何必须解引用方法的结果的原因是如果deref方法就返回值，使用*总是会获取其所有权。

+

函数和方法的隐式解引用强制多态

 +

Rust 倾向于偏爱明确而不是隐晦，不过一个情况下这并不成立，就是函数和方法的参数的解引用强制多态（deref coercions）。解引用强制多态会自动的将指针或智能指针的引用转换为指针内容的引用。解引用强制多态发生于一个值被传递给函数或方法，并只发生于需要将传递的值类型与签名中参数类型相匹配的时候。解引用强制多态的加入使得 Rust 调用函数或方法时无需很多使用&和*的引用和解引用。

+

使用列表 15-5 中的Mp3结构体，如下是一个获取u8 slice 并压缩 mp3 音频数据的函数签名：

+
fn compress_mp3(audio: &[u8]) -> Vec<u8> {
+    // the actual implementation would go here
+}
+
+

如果 Rust 没有解引用强制多态，为了使用my_favorite_song中的音频数据调用此函数，必须写成：

+
compress_mp3(my_favorite_song.audio.as_slice())
+
+

也就是说，必须明确表用需要my_favorite_song中的audio字段而且我们希望有一个 slice 来引用这整个Vec<u8>。如果有很多地方需要用相同的方式处理audio数据，那么.audio.as_slice()就显得冗长重复了。

+

然而，因为解引用强制多态和Mp3的Deref trait 实现，我们可以使用如下代码使用my_favorite_song中的数据调用这个函数：

+
let result = compress_mp3(&my_favorite_song);
+
+

只有&和实例，好的！我们可以把智能指针当成普通的引用。也就是说解引用强制多态意味着 Rust 利用了Deref实现的优势：Rust 知道Mp3实现了Deref trait 并从deref方法返回&Vec<u8>。它也知道标准库实现了Vec<T>的Deref trait，其deref方法返回&[T]（我们也可以通过查阅Vec<T>的 API 文档来发现这一点）。所以，在编译时，Rust 会发现它可以调用两次Deref::deref来将&Mp3变成&Vec<u8>再变成&[T]来满足compress_mp3的签名。这意味着我们可以少写一些代码！Rust 会多次分析Deref::deref的返回值类型直到它满足参数的类型，只要相关类型实现了Deref trait。这些间接转换在编译时进行，所以利用解引用强制多态并没有运行时惩罚。

+

这里还有一个重载了&mut T的*的DerefMut trait，它以与Deref重载&T的*相同的方式用于参数中。

+

Rust 在发现类型和 trait 实现满足三种情况时会进行解引用强制多态：

+ +

头两个情况除了可变性之外是相同的：如果有一个&T，而T实现了返回U类型的Deref，可以直接得到&U。对于可变引用也是一样。最后一个有些微妙：如果有一个可变引用，它也可以强转为一个不可变引用。反之则是_不可能_的：不可变引用永远也不能强转为可变引用。

+

Deref trait 对于只能指针模式十分重要的原因在于智能指针可以被看作普通引用并用于期望使用引用的地方。例如，无需重新编写方法和函数来直接获取智能指针。

+

Drop Trait 运行清理代码

 +
+

ch15-03-drop.md +
+commit 3f2a1bd8dbb19cc48b210fc4fb35c305c8d81b56

+
+

对于智能指针模式来说另一个重要的 trait 是Drop。Drop运行我们在值要离开作用域时执行一些代码。智能指针在被丢弃时会执行一些重要的清理工作，比如释放内存或减少引用计数。更一般的来讲，数据类型可以管理多于内存的资源，比如文件或网络连接，而使用Drop在代码处理完他们之后释放这些资源。我们在智能指针上下文中讨论Drop是因为其功能几乎总是用于实现智能指针。

+

在其他一些语言中，必须每次总是必须记住在使用完智能指针实例后调用清理内存或资源的代码。如果忘记的话，运行代码的系统可能会因为负荷过重而崩溃。在 Rust 中，可以指定一些代码应该在值离开作用域时被执行，而编译器会自动插入这些代码。这意味着无需记住在所有处理完这些类型实例后调用清理代码，而仍然不会泄露资源！

+

指定在值离开作用域时应该执行的代码的方式是实现Drop trait。Drop trait 要求我们实现一个叫做drop的方法，它获取一个self的可变引用。

+

列表 15-8 展示了并没有实际功能的结构体CustomSmartPointer，不过我们会在创建实例之后打印出CustomSmartPointer created.，而在实例离开作用域时打印出Dropping CustomSmartPointer!，这样就能看出哪些代码被执行了。不同于println!语句，我们在智能指针需要执行清理代码时使用drop：

+

Filename: src/main.rs

+
struct CustomSmartPointer {
+    data: String,
+}
+
+impl Drop for CustomSmartPointer {
+    fn drop(&mut self) {
+        println!("Dropping CustomSmartPointer!");
+    }
+}
+
+fn main() {
+    let c = CustomSmartPointer { data: String::from("some data") };
+    println!("CustomSmartPointer created.");
+    println!("Wait for it...");
+}
+
+

Listing 15-8: A CustomSmartPointer struct that +implements the Drop trait, where we could put code that would clean up after +the CustomSmartPointer.

+

Drop trait 位于 prelude 中，所以无需导入它。drop方法的实现调用了println!；这里是你需要实际需要放入关闭套接字代码的地方。在main函数中，我们创建一个CustomSmartPointer的新实例并打印出CustomSmartPointer created.以便在运行时知道代码运行到此出。在main的结尾，CustomSmartPointer的实例会离开作用域。注意我们没有显式调用drop方法：

+

当运行这个程序，我们会看到：

+
CustomSmartPointer created.
+Wait for it...
+Dropping CustomSmartPointer!
+
diff --git a/src/ch15-02-deref.md b/src/ch15-02-deref.md index 9708c76..09d7fc4 100644 --- a/src/ch15-02-deref.md +++ b/src/ch15-02-deref.md @@ -19,4 +19,96 @@ let mut x = 5; assert_eq!(6, x); ``` -我们使用`*y`来访问可变引用`y`所指向的数据， \ No newline at end of file +我们使用`*y`来访问可变引用`y`所指向的数据，而是可变引用本身。接着可以修改它的数据，在这里对其加一。 + +引用并不是智能指针，他们只是引用指向的一个值，所以这个解引用操作是很直接的。智能指针还会储存指针或数据的元数据。当解引用一个智能指针时，我们只想要数据，而不需要元数据。我们希望能在使用常规引用的地方也能使用智能指针。为此，可以通过实现`Deref` trait 来重载`*`运算符的行为。 + +列表 15-7 展示了一个定义为储存 mp3 数据和元数据的结构体通过`Deref` trait 来重载`*`的例子。`Mp3`，在某种意义上是一个智能指针：它拥有包含音频的`Vec`数据。另外，它储存了一些可选的元数据，在这个例子中是音频数据中艺术家和歌曲的名称。我们希望能够方便的访问音频数据而不是元数据，所以需要实现`Deref` trait 来返回音频数据。实现`Deref` trait 需要一个叫做`deref`的方法，它借用`self`并返回其内部数据： + +Filename: src/main.rs + +```rust +use std::ops::Deref; + +struct Mp3 { + audio: Vec, + artist: Option, + title: Option, +} + +impl Deref for Mp3 { + type Target = Vec; + + fn deref(&self) -> &Vec { + &self.audio + } +} + +fn main() { + let my_favorite_song = Mp3 { + // we would read the actual audio data from an mp3 file + audio: vec![1, 2, 3], + artist: Some(String::from("Nirvana")), + title: Some(String::from("Smells Like Teen Spirit")), + }; + + assert_eq!(vec![1, 2, 3], *my_favorite_song); +} +``` + +Listing 15-7: An implementation of the `Deref` trait on a +struct that holds mp3 file data and metadata + +大部分代码看起来都比较熟悉：一个结构体、一个 trait 实现、和一个创建了结构体示例的 main 函数。其中有一部分我们还未全面的讲解：类似于第十三章学习迭代器 trait 时出现的`type Item`，`type Target = T;`语法用于定义关联类型，第十九章会更详细的介绍。不必过分担心例子中的这一部分；它只是一个稍显不同的定义泛型参数的方式。 + +在`assert_eq!`中，我们验证`vec![1, 2, 3]`是否为`Mp3`实例`*my_favorite_song`解引用的值，结果正是如此因为我们实现了`deref`方法来返回音频数据。如果没有为`Mp3`实现`Deref` trait，Rust 将不会编译`*my_favorite_song`：会出现错误说`Mp3`类型不能被解引用。 + +代码能够工作的原因在于调用`*my_favorite_song`时`*`在背后所做的操作： + +```rust,ignore +*(my_favorite_song.deref()) +``` + +这对`my_favorite_song`调用了`deref`方法，它借用了`my_favorite_song`并返回指向`my_favorite_song.audio`的引用，这正是列表 15-5 中`deref`所定义的。引用的`*`被定义为仅仅从引用中返回其数据，所以上面`*`的展开形式对于外部`*`来说并不是递归的。最终的数据类型是`Vec`，它与列表 15-5 中`assert_eq!`的`vec![1, 2, 3]`相匹配。 + +`deref`方法的返回值类型仍然是引用和为何必须解引用方法的结果的原因是如果`deref`方法就返回值，使用`*`总是会获取其所有权。 + +### 函数和方法的隐式解引用强制多态 + +Rust 倾向于偏爱明确而不是隐晦，不过一个情况下这并不成立，就是函数和方法的参数的**解引用强制多态**（*deref coercions*）。解引用强制多态会自动的将指针或智能指针的引用转换为指针内容的引用。解引用强制多态发生于一个值被传递给函数或方法，并只发生于需要将传递的值类型与签名中参数类型相匹配的时候。解引用强制多态的加入使得 Rust 调用函数或方法时无需很多使用`&`和`*`的引用和解引用。 + +使用列表 15-5 中的`Mp3`结构体，如下是一个获取`u8` slice 并压缩 mp3 音频数据的函数签名： + +```rust,ignore +fn compress_mp3(audio: &[u8]) -> Vec { + // the actual implementation would go here +} +``` + +如果 Rust 没有解引用强制多态，为了使用`my_favorite_song`中的音频数据调用此函数，必须写成： + +```rust,ignore +compress_mp3(my_favorite_song.audio.as_slice()) +``` + +也就是说，必须明确表用需要`my_favorite_song`中的`audio`字段而且我们希望有一个 slice 来引用这整个`Vec`。如果有很多地方需要用相同的方式处理`audio`数据，那么`.audio.as_slice()`就显得冗长重复了。 + +然而，因为解引用强制多态和`Mp3`的`Deref` trait 实现，我们可以使用如下代码使用`my_favorite_song`中的数据调用这个函数： + +```rust,ignore +let result = compress_mp3(&my_favorite_song); +``` + +只有`&`和实例，好的！我们可以把智能指针当成普通的引用。也就是说解引用强制多态意味着 Rust 利用了`Deref`实现的优势：Rust 知道`Mp3`实现了`Deref` trait 并从`deref`方法返回`&Vec`。它也知道标准库实现了`Vec`的`Deref` trait，其`deref`方法返回`&[T]`（我们也可以通过查阅`Vec`的 API 文档来发现这一点）。所以，在编译时，Rust 会发现它可以调用两次`Deref::deref`来将`&Mp3`变成`&Vec`再变成`&[T]`来满足`compress_mp3`的签名。这意味着我们可以少写一些代码！Rust 会多次分析`Deref::deref`的返回值类型直到它满足参数的类型，只要相关类型实现了`Deref` trait。这些间接转换在编译时进行，所以利用解引用强制多态并没有运行时惩罚。 + +这里还有一个重载了`&mut T`的`*`的`DerefMut` trait，它以与`Deref`重载`&T`的`*`相同的方式用于参数中。 + +Rust 在发现类型和 trait 实现满足三种情况时会进行解引用强制多态： + +* 从`&T`到`&U`当`T: Deref`。 +* 从`&mut T`到`&mut U`当`T: DerefMut`。 +* 从`&mut T`到`&U`当`T: Deref`。 + +头两个情况除了可变性之外是相同的：如果有一个`&T`，而`T`实现了返回`U`类型的`Deref`，可以直接得到`&U`。对于可变引用也是一样。最后一个有些微妙：如果有一个可变引用，它也可以强转为一个不可变引用。反之则是_不可能_的：不可变引用永远也不能强转为可变引用。 + +`Deref` trait 对于只能指针模式十分重要的原因在于智能指针可以被看作普通引用并用于期望使用引用的地方。例如，无需重新编写方法和函数来直接获取智能指针。 \ No newline at end of file diff --git a/src/ch15-03-drop.md b/src/ch15-03-drop.md index e69de29..de65fbf 100644 --- a/src/ch15-03-drop.md +++ b/src/ch15-03-drop.md @@ -0,0 +1,48 @@ +## `Drop` Trait 运行清理代码 + +> [ch15-03-drop.md](https://github.com/rust-lang/book/blob/master/second-edition/src/ch15-03-drop.md) +>
+> commit 3f2a1bd8dbb19cc48b210fc4fb35c305c8d81b56 + +对于智能指针模式来说另一个重要的 trait 是`Drop`。`Drop`运行我们在值要离开作用域时执行一些代码。智能指针在被丢弃时会执行一些重要的清理工作，比如释放内存或减少引用计数。更一般的来讲，数据类型可以管理多于内存的资源，比如文件或网络连接，而使用`Drop`在代码处理完他们之后释放这些资源。我们在智能指针上下文中讨论`Drop`是因为其功能几乎总是用于实现智能指针。 + +在其他一些语言中，必须每次总是必须记住在使用完智能指针实例后调用清理内存或资源的代码。如果忘记的话，运行代码的系统可能会因为负荷过重而崩溃。在 Rust 中，可以指定一些代码应该在值离开作用域时被执行，而编译器会自动插入这些代码。这意味着无需记住在所有处理完这些类型实例后调用清理代码，而仍然不会泄露资源！ + +指定在值离开作用域时应该执行的代码的方式是实现`Drop` trait。`Drop` trait 要求我们实现一个叫做`drop`的方法，它获取一个`self`的可变引用。 + +列表 15-8 展示了并没有实际功能的结构体`CustomSmartPointer`，不过我们会在创建实例之后打印出`CustomSmartPointer created.`，而在实例离开作用域时打印出`Dropping CustomSmartPointer!`，这样就能看出哪些代码被执行了。不同于`println!`语句，我们在智能指针需要执行清理代码时使用`drop`： + +Filename: src/main.rs + +```rust +struct CustomSmartPointer { + data: String, +} + +impl Drop for CustomSmartPointer { + fn drop(&mut self) { + println!("Dropping CustomSmartPointer!"); + } +} + +fn main() { + let c = CustomSmartPointer { data: String::from("some data") }; + println!("CustomSmartPointer created."); + println!("Wait for it..."); +} +``` + +Listing 15-8: A `CustomSmartPointer` struct that +implements the `Drop` trait, where we could put code that would clean up after +the `CustomSmartPointer`. + +`Drop` trait 位于 prelude 中，所以无需导入它。`drop`方法的实现调用了`println!`；这里是你需要实际需要放入关闭套接字代码的地方。在`main`函数中，我们创建一个`CustomSmartPointer`的新实例并打印出`CustomSmartPointer created.`以便在运行时知道代码运行到此出。在`main`的结尾，`CustomSmartPointer`的实例会离开作用域。注意我们没有显式调用`drop`方法： + +当运行这个程序，我们会看到： + +``` +CustomSmartPointer created. +Wait for it... +Dropping CustomSmartPointer! +``` +