check to ch02-00

pull/146/head
KaiserY 7 years ago
parent 5e2b246777
commit 2767e943b2

@ -1,7 +1,3 @@
# Rust 程序设计语言(第二版) 简体中文版 # Rust 程序设计语言(第二版) 简体中文版
还在施工中:目前翻译到第十六章,正在更新第十二章 还在施工中...
目前官方进度:[第十七章](https://github.com/rust-lang/book/projects/1)18~20 章还在编写当中)
GitBook 代码排版已大体解决,已不影响阅读

@ -9,7 +9,7 @@
"description": "Rust 程序设计语言 简体中文版", "description": "Rust 程序设计语言 简体中文版",
"author": "Steve Klabnik 和 Carol Nichols以及来自 Rust 社区的贡献KaiserY 译", "author": "Steve Klabnik 和 Carol Nichols以及来自 Rust 社区的贡献KaiserY 以及 Rust 中文社区翻译",
"language": "zh-hans", "language": "zh-hans",

@ -1,5 +1,5 @@
title = "Rust 程序设计语言 简体中文版" title = "Rust 程序设计语言 简体中文版"
author = "Steve Klabnik 和 Carol Nichols以及来自 Rust 社区的贡献KaiserY 译" author = "Steve Klabnik 和 Carol Nichols以及来自 Rust 社区的贡献KaiserY 以及 Rust 中文社区翻译"
description = "Rust 程序设计语言 简体中文版" description = "Rust 程序设计语言 简体中文版"
[output.html] [output.html]

@ -1,7 +1,3 @@
# Rust 程序设计语言(第二版) 简体中文版 # Rust 程序设计语言(第二版) 简体中文版
还在施工中:目前翻译到第十六章,正在更新第十二章 还在施工中...
目前官方进度:[第十七章](https://github.com/rust-lang/book/projects/1)18~20 章还在编写当中)
GitBook 代码排版已大体解决,已不影响阅读

@ -20,6 +20,6 @@ registry site[crates.io]!我们由衷期待**你**使用 Rust 进行创
[on GitHub]: https://github.com/rust-lang/book [on GitHub]: https://github.com/rust-lang/book
[CONTRIBUTING.md]: https://github.com/rust-lang/book/blob/master/CONTRIBUTING.md [CONTRIBUTING.md]: https://github.com/rust-lang/book/blob/master/CONTRIBUTING.md
> 译者注:译本的 [GitHub 仓库][trpl-zh-cn],同样欢迎 Issue 和 PR :) > 译者注:译本的 [GitHub 仓库][trpl-zh-cn],同样欢迎 Issue 和 PR :)
[trpl-zh-cn]: https://github.com/KaiserY/trpl-zh-cn [trpl-zh-cn]: https://github.com/KaiserY/trpl-zh-cn

@ -2,7 +2,7 @@
> [ch01-01-installation.md](https://github.com/rust-lang/book/blob/master/second-edition/src/ch01-01-installation.md) > [ch01-01-installation.md](https://github.com/rust-lang/book/blob/master/second-edition/src/ch01-01-installation.md)
> <br> > <br>
> commit d06a6a181fd61704cbf7feb55bc61d518c6469f9 > commit b6dcc87f2b811c88fc741c86cf6ed3976333acba
使用 Rust 的第一步是安装。你需要网络连接来执行本章的命令,因为将要从网上下载 Rust。 使用 Rust 的第一步是安装。你需要网络连接来执行本章的命令,因为将要从网上下载 Rust。
@ -22,7 +22,7 @@ $ curl https://sh.rustup.rs -sSf | sh
Rust is installed now. Great! Rust is installed now. Great!
``` ```
当然,如果你对于 `curl | sh` 这样的模式心有疑虑,请随意下载、检查和运行这个脚本。 当然,如果你不信任采用 `curl URL | sh` 来安装软禁啊,请随意下载、检查和运行这个脚本。
此安装脚本自动将 Rust 加入系统 PATH 环境变量中,再次登陆时生效。如果你希望立刻(不重新登陆)就开始使用 Rust在 shell 中运行如下命令: 此安装脚本自动将 Rust 加入系统 PATH 环境变量中,再次登陆时生效。如果你希望立刻(不重新登陆)就开始使用 Rust在 shell 中运行如下命令:

@ -2,15 +2,15 @@
> [ch01-02-hello-world.md](https://github.com/rust-lang/book/blob/master/second-edition/src/ch01-02-hello-world.md) > [ch01-02-hello-world.md](https://github.com/rust-lang/book/blob/master/second-edition/src/ch01-02-hello-world.md)
> <br> > <br>
> commit d06a6a181fd61704cbf7feb55bc61d518c6469f9 > commit c21a4e7b315d62583470482ab542587a26e1b2e8
现在安装好了 Rust让我们来编写第一个程序。当学习一门新语言的时候使用该语言在屏幕上打印 “Hello, world!” 是一项传统,我们将遵循这个传统。 现在安装好了 Rust让我们来编写第一个程序。当学习一门新语言的时候使用该语言在屏幕上打印 “Hello, world!” 是一项传统,这里我们将遵循这个传统。
> 注意本书假设你熟悉基本的命令行操作。Rust 对于你的编辑器、工具,以及代码位于何处并没有特定的要求,如果相比命令行你更倾向于 IDE请随意使用合意的 IDE。 > 注意本书假设你熟悉基本的命令行操作。Rust 对于你的编辑器、工具,以及代码位于何处并没有特定的要求,如果相比命令行你更倾向于 IDE请随意使用合意的 IDE。
### 创建项目目录 ### 创建项目目录
首先,创建一个存放 Rust 代码的目录。Rust 并不关心代码的位置,不过在本书中,我们建议你在 home 目录中创建一个 *projects* 目录,并把你的所有项目放在这。打开一个终端,输入如下命令为这个项目创建一个文件夹 首先,创建一个存放 Rust 代码的目录。Rust 并不关心代码的位置,不过在本书中,我们建议你在 home 目录中创建一个 *projects* 目录,并将你的所有项目置于此处。打开终端并输入如下命令为此项目创建一个目录
Linux 和 Mac Linux 和 Mac
@ -61,11 +61,11 @@ $ ./main
Hello, world! Hello, world!
``` ```
在 Windows 上,运行 `.\main.exe`,而不是`./main`。不管使用何种系统,应该在终端看到 `Hello, world!` 字样。如果你做到了,恭喜你!你已经正式编写了一个 Rust 程序。现在你成为了一名 Rust 程序员!欢迎! 在 Windows 上,运行 `.\main.exe`,而不是`./main`。不管使用何种系统,应该在终端看到 `Hello, world!` 字样。如果你做到了,恭喜你!你已经正式编写了一个 Rust 程序。现在你成为了一名 Rust 程序员!欢迎!
### 分析 Rust 程序 ### 分析 Rust 程序
现在,让我们回过头来仔细看看 “Hello, world!” 程序到底发生了什么。这是拼图的第一片: 现在,让我们回过头来仔细看看 “Hello, world!” 程序到底发生了什么。这是拼图的第一片:
```rust ```rust
fn main() { fn main() {
@ -73,7 +73,7 @@ fn main() {
} }
``` ```
这几行定义了一个 Rust **函数**。`main` 函数是特殊的:它是每个可执行的 Rust 程序首先执行的。第一行代码表示 “我声明了一个叫做 `main` 的函数,它没有参数也没有返回值。” 如果有参数的话,它们的名称应该出现在括号中,`(`和`)`之间。 这几行定义了一个 Rust **函数**。`main` 函数是特殊的:它是每个可执行的 Rust 程序首先执行的。第一行代码表示 “我声明了一个叫做 `main` 的函数,它没有参数也没有返回值。” 如果有参数的话,它们的名称应该出现在括号中,位于 `(` `)` 之间。
还须注意函数体被包裹在花括号中,`{`和`}` 之间。Rust 要求所有函数体都要用花括号包裹起来(译者注:有些语言,当函数体只有一行时可以省略花括号,但在 Rust 中是不行的)。一般来说,将左花括号与函数声明置于同一行并以空格分隔,是良好的代码风格。 还须注意函数体被包裹在花括号中,`{`和`}` 之间。Rust 要求所有函数体都要用花括号包裹起来(译者注:有些语言,当函数体只有一行时可以省略花括号,但在 Rust 中是不行的)。一般来说,将左花括号与函数声明置于同一行并以空格分隔,是良好的代码风格。
@ -85,7 +85,7 @@ fn main() {
这行代码完成这个小程序的所有工作:在屏幕上打印文本。这里有很多细节需要注意。首先 Rust 使用 4 个空格的缩进风格,而不是 1 个制表符tab 这行代码完成这个小程序的所有工作:在屏幕上打印文本。这里有很多细节需要注意。首先 Rust 使用 4 个空格的缩进风格,而不是 1 个制表符tab
第二个重要的部分是 `println!()`。这称为 Rust **宏**Rust 元编程metaprogramming的关键所在。如果是调用函数则应看起来像这样`println`(没有`!`)。我们将在附录 E 中更加详细的讨论宏,现在你只需记住,当看到符号 `!` 的时候,调用的是宏而不是普通函数。 第二个重要的部分是 `println!()`。这称为 Rust **宏**Rust 元编程metaprogramming的关键所在。如果是调用函数则应看起来像这样`println`(没有`!`)。我们将在附录 D 中更加详细的讨论宏,现在你只需记住,当看到符号 `!` 的时候,就意味着调用的是宏而不是普通函数。
接下来,`"Hello, world!"` 是一个 **字符串**。我们把这个字符串作为一个参数传递给 `println!`,它负责在屏幕上打印这个字符串。轻松加愉快!(⊙o⊙) 接下来,`"Hello, world!"` 是一个 **字符串**。我们把这个字符串作为一个参数传递给 `println!`,它负责在屏幕上打印这个字符串。轻松加愉快!(⊙o⊙)
@ -95,7 +95,7 @@ fn main() {
“编写并运行 Rust 程序” 部分中展示了如何运行新创建的程序。现在我们将拆分并检查每一步操作。 “编写并运行 Rust 程序” 部分中展示了如何运行新创建的程序。现在我们将拆分并检查每一步操作。
在运行一个 Rust 程序之前必须先进行编译。可以通过 `rustc` 命令来使用 Rust 编译器,并传递源文件的名字给它,如下: 在运行 Rust 程序之前必须先进行编译。可以通过 `rustc` 命令并传递源文件名称来使用 Rust 编译器,如下:
```text ```text
$ rustc main.rs $ rustc main.rs
@ -124,15 +124,15 @@ $ ./main # or .\main.exe on Windows
如果 *main.rs* 是上文所述的 “Hello, world!” 程序,它将会在终端上打印 `Hello, world!` 如果 *main.rs* 是上文所述的 “Hello, world!” 程序,它将会在终端上打印 `Hello, world!`
来自 Ruby、Python 或 JavaScript 这样的动态类型语言背景的同学可能不太习惯将编译和执行分为两个单独的步骤。Rust 是一种 **预编译静态类型语言***ahead-of-time compiled language*),这意味着你可以编译程序并将其交与他人,它们不需要安装 Rust 即可运行。相反如果你给他们一个 `.rb`、`.py` 或 `.js` 文件,他们需要先分别安装 RubyPythonJavaScript 实现运行时环境VM不过你只需要一句命令就可以编译和执行程序。这一切都是语言设计上的权衡取舍。 来自 Ruby、Python 或 JavaScript 这样的动态类型语言背景的同学可能不太习惯将编译和执行分为两个单独的步骤。Rust 是一种 **预编译静态类型***ahead-of-time compiled*语言,这意味着你可以编译程序并将其交与他人,它们不需要安装 Rust 即可运行。相反如果你给他们一个 `.rb`、`.py` 或 `.js` 文件,他们需要先分别安装 RubyPythonJavaScript 实现运行时环境VM不过你只需要一句命令就可以编译和执行程序。这一切都是语言设计上的权衡取舍。
使用 `rustc` 编译简单程序是没问题的,不过随着项目的增长,你可能需要控制你项目的方方面面,并且更容易地将代码分享给其它人或项目。接下来,我们要介绍一个叫做 Cargo 的工具,它会帮助你编写真实世界中的 Rust 程序。 使用 `rustc` 编译简单程序是没问题的,不过随着项目的增长,你可能需要控制你项目的方方面面,并且更容易地将代码分享给其它人或项目。接下来,我们要介绍一个叫做 Cargo 的工具,它会帮助你编写真实世界中的 Rust 程序。
## Hello, Cargo! ## Hello, Cargo!
Cargo 是 Rust 的构建系统和包管理工具,同时 Rustacean 们使用 Cargo 来管理他们的 Rust 项目它使得很多任务变得更轻松。例如Cargo 负责构建代码、下载依赖库并编译它们。我们把代码需要的库叫做 **依赖***dependencies*)。 Cargo 是 Rust 的构建系统和包管理工具,同时 Rustacean 们使用 Cargo 来管理他们的 Rust 项目,因为它使得很多任务变得更轻松。例如Cargo 负责构建代码、下载依赖库并编译它们。我们把代码需要的库叫做 **依赖***dependencies*)。
最简单的 Rust 程序,比如我们刚刚编写的,并没有任何依赖,所以我们只使用了 Cargo 构建代码的功能。随着编写的程序更加复杂,你会想要添加依赖,如果你使用 Cargo 开始的话,这将会变得简单许多。 最简单的 Rust 程序,比如我们刚刚编写的,并没有任何依赖,所以目前我们只会用到 Cargo 构建代码那部分的功能。随着编写的程序更加复杂,你会想要添加依赖,如果你一开始就使用 Cargo 的话,事情会变得简单许多。
由于绝大部分 Rust 项目使用 Cargo本书接下来的部分将假设你使用它。如果使用之前介绍的官方安装包的话则自带了 Cargo。如果通过其他方式安装的话可以在终端输入如下命令检查是否安装了 Cargo 由于绝大部分 Rust 项目使用 Cargo本书接下来的部分将假设你使用它。如果使用之前介绍的官方安装包的话则自带了 Cargo。如果通过其他方式安装的话可以在终端输入如下命令检查是否安装了 Cargo
@ -167,7 +167,7 @@ $ cd hello_cargo
我们向 `cargo new` 传递了 `--bin`,因为我们的目标是生成一个可执行程序,而不是一个库。可执行程序是二进制可执行文件,通常就叫做 **二进制文件***binaries*)。项目的名称被定为 `hello_cargo`,同时 Cargo 在一个同名目录中创建它的文件,接着我们可以进入查看。 我们向 `cargo new` 传递了 `--bin`,因为我们的目标是生成一个可执行程序,而不是一个库。可执行程序是二进制可执行文件,通常就叫做 **二进制文件***binaries*)。项目的名称被定为 `hello_cargo`,同时 Cargo 在一个同名目录中创建它的文件,接着我们可以进入查看。
如果列出 *hello_cargo* 目录中的文件,将会看到 Cargo 生成了一个文件和一个目录:一个 *Cargo.toml* 文件和一个 *src* 目录,*main.rs* 文件位于 *src* 目录中。它也在 *hello_cargo* 目录初始化了一个 git 仓库,以及一个 *.gitignore* 文件;你可以通过`--vcs`参数切换到其它版本控制系统VCS或者不使用 VCS。 如果列出 *hello_cargo* 目录中的文件,将会看到 Cargo 生成了一个文件和一个目录:一个 *Cargo.toml* 文件和一个 *src* 目录,*main.rs* 文件位于 *src* 目录中。它也在 *hello_cargo* 目录初始化了一个 git 仓库,以及一个 *.gitignore* 文件;你可以通过 `--vcs` 参数切换到其它版本控制系统VCS或者不使用 VCS。
使用文本编辑器(工具请随意)打开 *Cargo.toml* 文件。它应该看起来像这样: 使用文本编辑器(工具请随意)打开 *Cargo.toml* 文件。它应该看起来像这样:
@ -186,11 +186,11 @@ authors = ["Your Name <you@example.com>"]
[toml]: https://github.com/toml-lang/toml [toml]: https://github.com/toml-lang/toml
第一行,`[package]`,是一个段落标题,表明下面的语句用来配置一个包。随着我们在这个文件增加更多的信息,还将增加其他段落 第一行,`[package]`,是一个部分标题,表明下面的语句用来配置一个包。随着我们在这个文件增加更多的信息,还将增加其他部分
接下来的三行设置了三个 Cargo 所需的配置,项目的名称、版本和作者,它们告诉 Cargo 需要编译这个项目。Cargo 从环境中获取你的名称和 email 信息。如果不正确,请修改并保存此文件。 接下来的三行设置了三个 Cargo 所需的配置,项目的名称、版本和作者,它们告诉 Cargo 需要编译这个项目。Cargo 从环境中获取你的名称和 email 信息。如果不正确,请修改并保存此文件。
最后一行,`[dependencies]`,是项目依赖的 *crates* 列表(我们称呼 Rust 代码包为 crate段落的开始,这样 Cargo 就知道应该下载和编译它们了。这个项目并不需要任何其他的 crate不过在下一章猜猜看教程会用得上。 最后一行,`[dependencies]`,是项目依赖的 *crates* 列表(我们称呼 Rust 代码包为 crate部分的开始,这样 Cargo 就知道应该下载和编译它们了。这个项目并不需要任何其他的 crate不过在下一章猜猜看教程会用得上。
现在看看 *src/main.rs* 现在看看 *src/main.rs*
@ -218,16 +218,17 @@ Cargo 期望源文件位于 *src* 目录,将项目根目录留给 README、lic
```text ```text
$ cargo build $ cargo build
Compiling hello_cargo v0.1.0 (file:///projects/hello_cargo) Compiling hello_cargo v0.1.0 (file:///projects/hello_cargo)
Finished dev [unoptimized + debuginfo] target(s) in 2.85 secs
``` ```
这应该会创建 *target/debug/hello_cargo*可执行文件(或者在 Windows 上是 *target\debug\hello_cargo.exe*),可以通过这个命令运行: 这应该会创建 *target/debug/hello_cargo* 可执行文件(或者在 Windows 上是 *target\debug\hello_cargo.exe*),可以通过这个命令运行:
```text ```text
$ ./target/debug/hello_cargo # or .\target\debug\hello_cargo.exe on Windows $ ./target/debug/hello_cargo # or .\target\debug\hello_cargo.exe on Windows
Hello, world! Hello, world!
``` ```
很好!如果一切顺利,`Hello, world!`应该再次打印在终端上。 很好!如果一切顺利,`Hello, world!` 应该再次打印在终端上。
首次运行 `cargo build` 的时候Cargo 会在项目根目录创建一个新文件,*Cargo.lock*,它看起来像这样: 首次运行 `cargo build` 的时候Cargo 会在项目根目录创建一个新文件,*Cargo.lock*,它看起来像这样:
@ -254,13 +255,14 @@ Hello, world!
```text ```text
$ cargo run $ cargo run
Compiling hello_cargo v0.1.0 (file:///projects/hello_cargo) Compiling hello_cargo v0.1.0 (file:///projects/hello_cargo)
Finished dev [unoptimized + debuginfo] target(s) in 0.33 secs
Running `target/debug/hello_cargo` Running `target/debug/hello_cargo`
Hello, world! Hello, world!
``` ```
所以现在又出现更多的不同: 所以现在又出现更多的不同:
- 使用 `cargo build` 构建项目(或使用 `cargo run` 一步构建并运行),而不是使用`rustc` - 使用 `cargo build` 构建项目(或使用 `cargo run` 一步构建并运行),而不是使用 `rustc`
- 有别于将构建结果放在与源码相同的目录Cargo 会将其放到 *target/debug* 目录。 - 有别于将构建结果放在与源码相同的目录Cargo 会将其放到 *target/debug* 目录。
Cargo 的另一个优点是,不管你使用什么操作系统其命令都是一样的,所以本书之后将不再为 Linux 和 Mac 以及 Windows 提供相应的命令。 Cargo 的另一个优点是,不管你使用什么操作系统其命令都是一样的,所以本书之后将不再为 Linux 和 Mac 以及 Windows 提供相应的命令。

@ -2,7 +2,7 @@
> [ch02-00-guessing-game-tutorial.md](https://github.com/rust-lang/book/blob/master/second-edition/src/ch02-00-guessing-game-tutorial.md) > [ch02-00-guessing-game-tutorial.md](https://github.com/rust-lang/book/blob/master/second-edition/src/ch02-00-guessing-game-tutorial.md)
> <br> > <br>
> commit 2e269ff82193fd65df8a87c06561d74b51ac02f7 > commit 8a145ebea5c05f07fc240269bc9557340972188f
让我们一起动手完成一个项目,来快速上手 Rust本章将介绍 Rust 中常用的一些概念,并通过真实的程序来展示如何运用它们。你将会学到更多诸如 `let`、`match`、方法、关联函数、外部 crate 等很多的知识!后继章节会深入探索这些概念的细节。在这一章,我们将练习基础。 让我们一起动手完成一个项目,来快速上手 Rust本章将介绍 Rust 中常用的一些概念,并通过真实的程序来展示如何运用它们。你将会学到更多诸如 `let`、`match`、方法、关联函数、外部 crate 等很多的知识!后继章节会深入探索这些概念的细节。在这一章,我们将练习基础。
@ -53,9 +53,9 @@ $ cargo run
Hello, world! Hello, world!
``` ```
`run` 命令适合用于需要快速迭代的项目,而这个游戏便是这样的项目:我们需要在下一步迭代之前快速测试。 `run` 命令适合用于需要快速迭代的项目,而这个游戏便是这样的项目:我们需要在下一步迭代之前快速测试每一步
重新打开 *src/main.rs* 文件。我们将会在这个文件中编写全部代码。 重新打开 *src/main.rs* 文件。我们将会在这个文件中编写全部代码。
## 处理一次猜测 ## 处理一次猜测
@ -88,7 +88,7 @@ fn main() {
use std::io; use std::io;
``` ```
Rust 默认只在每个程序的 [*prelude*][prelude]<!-- ignore --> 中引入少量类型。如果需要的类型不在 prelude 中,你必须使用一个 `use` 语句显式的将其引入作用域。`std::io` 库提供很多 `io` 相关的功能,比如接受用户输入。 Rust 默认只在每个程序的 [*prelude*][prelude]<!-- ignore --> 中引入少量类型。如果需要的类型不在 prelude 中,你必须使用一个 `use` 语句显式的将其引入作用域。`std::io` 库提供很多 `io` 相关的功能,比如接受用户输入的功能
[prelude]: https://doc.rust-lang.org/std/prelude/index.html [prelude]: https://doc.rust-lang.org/std/prelude/index.html
@ -150,7 +150,7 @@ io::stdin().read_line(&mut guess)
.expect("Failed to read line"); .expect("Failed to read line");
``` ```
如果程序的开头没有 `use std::io` 这一行,可以把函数调用写成 `std::io::stdin`。`stdin` 函数返回一个 [`std::io::stdin`][iostdin]<!-- ignore --> 的实例,这代表终端标准输入句柄的类型。 如果程序的开头没有 `use std::io` 这一行,可以把函数调用写成 `std::io::stdin`。`stdin` 函数返回一个 [`std::io::stdin`][iostdin]<!-- ignore --> 的实例,这代表终端标准输入句柄的类型。
[iostdin]: https://doc.rust-lang.org/std/io/struct.Stdin.html [iostdin]: https://doc.rust-lang.org/std/io/struct.Stdin.html
@ -162,13 +162,13 @@ io::stdin().read_line(&mut guess)
`&` 表示这个参数是一个 **引用***reference*它允许多处代码访问同一处数据而无需在内存中多次拷贝。引用是一个复杂的特性Rust 的一个主要优势就是安全而简单的操纵引用。完成当前程序并不需要了解如此多细节:第四章会更全面的解释引用。现在,我们只需知道它像变量一样,默认是不可变的,需要写成 `&mut guess` 而不是 `&guess` 来使其可变。 `&` 表示这个参数是一个 **引用***reference*它允许多处代码访问同一处数据而无需在内存中多次拷贝。引用是一个复杂的特性Rust 的一个主要优势就是安全而简单的操纵引用。完成当前程序并不需要了解如此多细节:第四章会更全面的解释引用。现在,我们只需知道它像变量一样,默认是不可变的,需要写成 `&mut guess` 而不是 `&guess` 来使其可变。
我们还没有分析完这行代码。虽然这是单独一行代码,但它是一个逻辑行(虽然换行了但仍是一个语句)的第一部分。第二部分是这个方法: 我们还没有完全分析完这行代码。虽然这是单独一行代码,但它是一个逻辑行(虽然换行了但仍是一个语句)的第一部分。第二部分是这个方法:
```rust,ignore ```rust,ignore
.expect("Failed to read line"); .expect("Failed to read line");
``` ```
当使用 `.foo()` 语法调用方法时,通过换行并缩进来把长行拆开是明智的。我们完全可以这样写: 当使用 `.foo()` 语法调用方法时,通过换行并缩进来把长行拆开是明智的。我们完全可以这样写:
```rust,ignore ```rust,ignore
io::stdin().read_line(&mut guess).expect("Failed to read line"); io::stdin().read_line(&mut guess).expect("Failed to read line");
@ -187,24 +187,27 @@ io::stdin().read_line(&mut guess).expect("Failed to read line");
[enums]: ch06-00-enums.html [enums]: ch06-00-enums.html
对于 `Result`,它的成员是 `Ok``Err``Ok` 表示操作成功,内部包含成功时产生的值。`Err` 意味着操作失败,包含失败的前因后果。 对于 `Result`,它的成员是 `Ok``Err``Ok` 表示操作成功,内部包含成功时产生的值。`Err` 意味着操作失败,并且包含失败的前因后果。
这些 `Result` 类型的作用是编码错误处理信息。`Result` 类型的值,像其他类型一样,拥有定义于其上的方法。`io::Result` 的实例拥有 [`expect` 方法][expect]<!-- ignore -->。如果 `io::Result` 实例的值是 `Err``expect` 会导致程序崩溃,并显示当做参数传递给 `expect` 的信息。如果 `read_line` 方法返回 `Err`,则可能是来源于底层操作系统错误的结果。如果 `io::Result` 实例的值是 `Ok``expect` 会获取 `Ok` 中的值并原样返回。在本例中,这个值是用户输入到标准输入中的字节的数量。 这些 `Result` 类型的作用是编码错误处理信息。`Result` 类型的值,像其他类型一样,拥有定义于其上的方法。`io::Result` 的实例拥有 [`expect` 方法][expect]<!-- ignore -->。如果 `io::Result` 实例的值是 `Err``expect` 会导致程序崩溃,并显示当做参数传递给 `expect` 的信息。如果 `read_line` 方法返回 `Err`,则可能是来源于底层操作系统错误的结果。如果 `io::Result` 实例的值是 `Ok``expect` 会获取 `Ok` 中的值并原样返回。在本例中,这个值是用户输入到标准输入中的字节的数量。
[expect]: https://doc.rust-lang.org/std/result/enum.Result.html#method.expect [expect]: https://doc.rust-lang.org/std/result/enum.Result.html#method.expect
如果不使`expect`,程序也能编译,不过会出现一个警告: 如果不`expect`,程序也能编译,不过会出现一个警告:
```text ```text
$ cargo build $ cargo build
Compiling guessing_game v0.1.0 (file:///projects/guessing_game) Compiling guessing_game v0.1.0 (file:///projects/guessing_game)
src/main.rs:10:5: 10:39 warning: unused result which must be used, warning: unused `std::result::Result` which must be used
#[warn(unused_must_use)] on by default --> src/main.rs:10:5
src/main.rs:10 io::stdin().read_line(&mut guess); |
^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 10 | io::stdin().read_line(&mut guess);
| ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
= note: #[warn(unused_must_use)] on by default
``` ```
Rust 警告我们没有使用 `read_line` 的返回值 `Result`,说明有一个可能的错误没有处理。想消除警告,就老实的写错误处理,不过我们就是希望程序在出现问题时立即崩溃,所以直接使用 `expect`。第九章会学习如何从错误中恢复。 Rust 警告我们没有使用 `read_line` 的返回值 `Result`,说明有一个可能的错误没有处理。消除警告的正确做法是实际编写错误处理代码,不过我们就是希望程序在出现问题时立即崩溃,所以直接使用 `expect`。第九章会学习如何从错误中恢复。
### 使用 `println!` 占位符打印值 ### 使用 `println!` 占位符打印值
@ -232,6 +235,7 @@ println!("x = {} and y = {}", x, y);
```text ```text
$ cargo run $ cargo run
Compiling guessing_game v0.1.0 (file:///projects/guessing_game) Compiling guessing_game v0.1.0 (file:///projects/guessing_game)
Finished dev [unoptimized + debuginfo] target(s) in 2.53 secs
Running `target/debug/guessing_game` Running `target/debug/guessing_game`
Guess the number! Guess the number!
Please input your guess. Please input your guess.
@ -249,9 +253,9 @@ You guessed: 6
### 使用 crate 来增加更多功能 ### 使用 crate 来增加更多功能
记住 *crate* 是一个 Rust 代码的包。我们正在构建的项目是一个**二进制 crate**,它生成一个可执行文件。 `rand` crate 是一个 **库 crate**,库 crate 可以包含任意能被其他程序使用的代码。 记住 *crate* 是一个 Rust 代码的包。我们正在构建的项目是一个 **二进制 crate**,它生成一个可执行文件。 `rand` crate 是一个 **库 crate**,库 crate 可以包含任意能被其他程序使用的代码。
Cargo 对外部 crate 的运用是其亮点。在我们使用 `rand` 编写代码之前,需要编辑 *Cargo.toml* ,声明 `rand` 作为一个依赖。现在打开这个文件并在底部的 `[dependencies]` 段落标题之下添加: Cargo 对外部 crate 的运用是其真正闪光的地方。在我们使用 `rand` 编写代码之前,需要编辑 *Cargo.toml* ,声明 `rand` 作为一个依赖。现在打开这个文件并在底部的 `[dependencies]` 部分标题之下添加:
<span class="filename">文件名: Cargo.toml</span> <span class="filename">文件名: Cargo.toml</span>
@ -261,7 +265,7 @@ Cargo 对外部 crate 的运用是其亮点。在我们使用 `rand` 编写代
rand = "0.3.14" rand = "0.3.14"
``` ```
*Cargo.toml* 文件中,标题以及之后的内容属同一个段落,直到遇到下一个标题才开始新的段落。`[dependencies]` 段落告诉 Cargo 本项目依赖了哪些外部 crate 及其版本。本例中,我们使用语义化版本 `0.3.14` 来指定 `rand` crate。Cargo 理解[语义化版本Semantic Versioning][semver]<!-- ignore -->(有时也称为 *SemVer*),这是一种定义版本号的标准。`0.3.14` 事实上是 `^0.3.14` 的简写,它表示 “任何与 0.3.14 版本公有 API 相兼容的版本”。 *Cargo.toml* 文件中,标题以及之后的内容属同一个部分,直到遇到下一个标题才开始新的部分。`[dependencies]` 部分告诉 Cargo 本项目依赖了哪些外部 crate 及其版本。本例中,我们使用语义化版本 `0.3.14` 来指定 `rand` crate。Cargo 理解[语义化版本Semantic Versioning][semver]<!-- ignore -->(有时也称为 *SemVer*),这是一种定义版本号的标准。`0.3.14` 事实上是 `^0.3.14` 的简写,它表示 “任何与 0.3.14 版本公有 API 相兼容的版本”。
[semver]: http://semver.org [semver]: http://semver.org
@ -275,6 +279,7 @@ $ cargo build
Compiling libc v0.2.14 Compiling libc v0.2.14
Compiling rand v0.3.14 Compiling rand v0.3.14
Compiling guessing_game v0.1.0 (file:///projects/guessing_game) Compiling guessing_game v0.1.0 (file:///projects/guessing_game)
Finished dev [unoptimized + debuginfo] target(s) in 2.53 secs
``` ```
<span class="caption">示例 2-2: 增加 rand crate 作为依赖之后运行 `cargo build` 的输出</span> <span class="caption">示例 2-2: 增加 rand crate 作为依赖之后运行 `cargo build` 的输出</span>
@ -287,18 +292,19 @@ $ cargo build
在更新完 registry 后Cargo 检查 `[dependencies]` 段落并下载缺失的部分。本例中,虽然只声明了 `rand` 一个依赖,然而 Cargo 还是额外获取了 `libc` 的拷贝,因为 `rand` 依赖 `libc` 来正常工作。下载完成后Rust 编译依赖,然后使用这些依赖编译项目。 在更新完 registry 后Cargo 检查 `[dependencies]` 段落并下载缺失的部分。本例中,虽然只声明了 `rand` 一个依赖,然而 Cargo 还是额外获取了 `libc` 的拷贝,因为 `rand` 依赖 `libc` 来正常工作。下载完成后Rust 编译依赖,然后使用这些依赖编译项目。
如果不做任何修改,立刻再次运行 `cargo build`则不会有任何输出。Cargo 知道它已经下载并编译了依赖,同时 *Cargo.toml* 文件也没有变动。Cargo 还知道代码也没有任何修改,所以它不会重新编译代码。因为无事可做,它简单的退出了。如果打开 *src/main.rs* 文件,做一些无关紧要的修改,保存并再次构建,只会出现行输出: 如果不做任何修改,立刻再次运行 `cargo build`则不会有任何输出。Cargo 知道它已经下载并编译了依赖,同时 *Cargo.toml* 文件也没有变动。Cargo 还知道代码也没有任何修改,所以它不会重新编译代码。因为无事可做,它简单的退出了。如果打开 *src/main.rs* 文件,做一些无关紧要的修改,保存并再次构建,只会出现行输出:
```text ```text
$ cargo build $ cargo build
Compiling guessing_game v0.1.0 (file:///projects/guessing_game) Compiling guessing_game v0.1.0 (file:///projects/guessing_game)
Finished dev [unoptimized + debuginfo] target(s) in 2.53 secs
``` ```
这一行表示 Cargo 只针对 *src/main.rs* 文件的微小修改而更新构建。依赖没有变化,所以 Cargo 知道它可以复用已经为此下载并编译的代码。它只是重新构建了部分(项目)代码。 这一行表示 Cargo 只针对 *src/main.rs* 文件的微小修改而更新构建。依赖没有变化,所以 Cargo 知道它可以复用已经为此下载并编译的代码。它只是重新构建了部分(项目)代码。
#### *Cargo.lock* 文件确保构建是可重现的 #### *Cargo.lock* 文件确保构建是可重现的
Cargo 有一个机制来确保任何人在任何时候重新构建代码都会产生相同的结果Cargo 只会使用你指定的依赖的版本,除非你又手动指定了别的。例如,如果下周 `rand` crate 的 `v0.3.15` 版本出来了,它修复了一个重要的 bug同时也含有一个缺陷,会破坏代码运行,这时会发生什么呢? Cargo 有一个机制来确保任何人在任何时候重新构建代码都会产生相同的结果Cargo 只会使用你指定的依赖的版本,除非你又手动指定了别的。例如,如果下周 `rand` crate 的 `v0.3.15` 版本出来了,它修复了一个重要的 bug同时也含有一个会破坏代码运行的缺陷,这时会发生什么呢?
这个问题的答案是 *Cargo.lock* 文件。它在第一次运行 `cargo build` 时创建,并放在 *guessing_game* 目录。当第一次构建项目时Cargo 计算出所有符合要求的依赖版本并写入 *Cargo.lock* 文件。当将来构建项目时Cargo 会发现 *Cargo.lock* 存在并使用其中指定的版本,而不是再次计算所有的版本。这使得你拥有了一个自动化的可重现的构建。换句话说,项目会持续使用 `0.3.14` 直到你显式升级,感谢 *Cargo.lock* 文件。 这个问题的答案是 *Cargo.lock* 文件。它在第一次运行 `cargo build` 时创建,并放在 *guessing_game* 目录。当第一次构建项目时Cargo 计算出所有符合要求的依赖版本并写入 *Cargo.lock* 文件。当将来构建项目时Cargo 会发现 *Cargo.lock* 存在并使用其中指定的版本,而不是再次计算所有的版本。这使得你拥有了一个自动化的可重现的构建。换句话说,项目会持续使用 `0.3.14` 直到你显式升级,感谢 *Cargo.lock* 文件。

Loading…
Cancel
Save