@ -71,17 +71,17 @@
< blockquote >
< p > < a href = "https://github.com/rust-lang/book/blob/master/src/ch02-00-guessing-game-tutorial.md" > ch02-00-guessing-game-tutorial.md< / a >
< br >
commit 7c1c935560190fcd64c0851e75dbeabf75fedd19 < / p >
commit e6d6caab41471f7115a621029bd428a812c5260e < / p >
< / blockquote >
< p > 让我们通过自己动手的方式一起完成一个项目来快速上手 Rust！ 通过展示如何在真实的项目中运用的方式向你介绍一些常用的 Rust 概念 。你将会学到< code > let< / code > 、< code > match< / code > 、方法、关联函数、使用外部 crate 等更多的知识！接下来的章节会探索这些概念的细节。在这一章，我们练习基础。< / p >
< p > 我们会实现一个经典新手编程问题：猜猜看游戏。它是这么工作的：程序将会随机生成一个 1 到 100 之间的随机整数。接着它会提示玩家输入一个猜测。当输入了一个猜测后，它会告诉 提示猜测是太大了还是太小了。猜对了，它会打印出祝贺并退出。< / p >
< p > 让我们通过自己动手的方式一起完成一个项目来快速上手 Rust！ 将介绍一些常用的 Rust 概念，并通过真实的程序来展示如何运用他们 。你将会学到< code > let< / code > 、< code > match< / code > 、方法、关联函数、使用外部 crate 等更多的知识！接下来的章节会探索这些概念的细节。在这一章，我们将 练习基础。< / p >
< p > 我们会实现一个经典的 新手编程问题：猜猜看游戏。它是这么工作的：程序将会随机生成一个 1 到 100 之间的随机整数。接着它会提示玩家输入一个猜测。当输入了一个猜测后，它会提示猜测是太大了还是太小了。如果 猜对了，它会打印出祝贺并退出。< / p >
< a class = "header" href = "#准备一个新项目" name = "准备一个新项目" > < h2 > 准备一个新项目< / h2 > < / a >
< p > 要创建一个新项目，进入你 在第一章创建的< strong > 项目< / strong > 目录，并使用 Cargo 创建它，像这样 ： < / p >
< pre > < code class = "language-sh" > $ cargo new guessing_game --bin
< p > 要创建一个新项目，进入在第一章创建的< strong > 项目< / strong > 目录，像这样使用 Cargo 创建它 ： < / p >
< pre > < code > $ cargo new guessing_game --bin
$ cd guessing_game
< / code > < / pre >
< p > 第一个命令，< code > cargo new< / code > ，获取项目的名称（< code > guessing_game< / code > ）作为第一个参数。< code > --bin< / code > 参数告诉 Cargo 创建一个二进制项目，与第一章类似。第二个命令进入到新创建的项目目录。< / p >
< p > 看一样 生成的 < em > Cargo.toml< / em > 文件：< / p >
< p > 看看 生成的 < em > Cargo.toml< / em > 文件：< / p >
< p > < span class = "filename" > Filename: Cargo.toml< / span > < / p >
< pre > < code class = "language-toml" > [package]
name = " guessing_game"
@ -90,7 +90,7 @@ authors = ["Your Name <you@example.com>"]
[dependencies]
< / code > < / pre >
< p > 如果 Cargo 从环境中获取的作 者信息不正确，修改这个文件并再次保存。< / p >
< p > 如果 Cargo 从环境中获取的开发 者信息不正确，修改这个文件并再次保存。< / p >
< p > 正如第一章那样，< code > cargo new< / code > 生成了一个“Hello, world!”程序。查看 < em > src/main.rs< / em > 文件：< / p >
< p > < span class = "filename" > Filename: src/main.rs< / span > < / p >
< pre > < code class = "language-rust" > fn main() {
@ -103,12 +103,11 @@ authors = ["Your Name <you@example.com>"]
Running `target/debug/guessing_game`
Hello, world!
< / code > < / pre >
< p > < code > run< / code > 命令在你 需要快速迭代项目时就派上用场了，而这个游戏就正是这么一个项目：我们需要在进行下一步之前快速测试每次迭代。< / p >
< p > < code > run< / code > 命令在需要快速迭代项目时就派上用场了，而这个游戏就正是这么一个项目：我们需要在进行下一步之前快速测试每次迭代。< / p >
< p > 重新打开 < em > src/main.rs< / em > 文件。我们将会在这个文件编写全部的代码。< / p >
< a class = "header" href = "#处理一次猜测" name = "处理一次猜测" > < h2 > 处理一次猜测< / h2 > < / a >
< p > 程序的第一部分会请求用户输入，处理输入，并检查输入是否为期望的形式。首先，允许玩家输入一个猜测。在 < em > src/main.rs< / em > 中输入列表 2-1 中的代码。< / p >
< figure >
< span class = "filename" > Filename: src/main.rs< / span >
< p > < span class = "filename" > Filename: src/main.rs< / span > < / p >
< pre > < code class = "language-rust,ignore" > use std::io;
fn main() {
@ -124,14 +123,11 @@ fn main() {
println!(" You guessed: {}" , guess);
}
< / code > < / pre >
< figcaption >
< p > Listing 2-1: Code to get a guess from the user and print it out< / p >
< / figcaption >
< / figure >
< p > < span class = "caption" > Listing 2-1: Code to get a guess from the user and print it out< / span > < / p >
< p > 这些代码包含很多信息，所以让我们一点一点地过一遍。为了获取用户输入并接着打印结果作为输出，我们需要将< code > io< / code > （输入/输出）库引入作用域中。< code > io< / code > 库来自于标准库（也被称为< code > std< / code > ） ： < / p >
< pre > < code class = "language-rust,ignore" > use std::io;
< / code > < / pre >
< p > Rust 默认只在每个程序的 < a href = "https://doc.rust-lang.org/std/prelude/ "> < em > prelude< / em > < / a > <!-- ignore --> 中引用很少的一些类型。如果想要使用的类型并不在 prelude 中，你必须使用一个< code > use< / code > 语句显式的将其引入到作用域中。使用< code > std::io< / code > 库将提供很多< code > io< / code > 相关的功能，接受用户输入的功能。< / p >
< p > Rust 默认只在每个程序的 < a href = "https://doc.rust-lang.org/std/prelude/ index.html "> < em > prelude< / em > < / a > <!-- ignore --> 中引用很少的一些类型。如果想要使用的类型并不在 prelude 中，你必须使用一个< code > use< / code > 语句显式的将其引入到作用域中。使用< code > std::io< / code > 库将提供很多< code > io< / code > 相关的功能，接受用户输入的功能。< / p >
< p > 正如第一章所讲，< code > main< / code > 函数是程序的入口点：< / p >
< pre > < code class = "language-rust,ignore" > fn main() {
< / code > < / pre >
@ -156,7 +152,7 @@ let mut bar = 5; // mutable
< blockquote >
< p > 注意：< code > //< / code > 开始一个注释， < / p >
< / blockquote >
< p > 现在我们知道了< code > let mut guess< / code > 会引入一个叫做< code > guess< / code > 的可变变量。等号（< code > =< / code > ）的另一边是< code > guess< / code > 所绑定的值，它是< code > String::new< / code > 的结果，这个函数会返回一个< code > String< / code > 的新实例。< a href = " ../std/string/struct.String.html"> < code > String< / code > < / a > <!-- ignore --> 是一个标准库提供的字符串类型， < / p >
< p > 现在我们知道了< code > let mut guess< / code > 会引入一个叫做< code > guess< / code > 的可变变量。等号（< code > =< / code > ）的另一边是< code > guess< / code > 所绑定的值，它是< code > String::new< / code > 的结果，这个函数会返回一个< code > String< / code > 的新实例。< a href = " https://doc .rust-lang .org /std/string/struct.String.html"> < code > String< / code > < / a > <!-- ignore --> 是一个标准库提供的字符串类型， < / p >
< p > < code > ::new< / code > 那一行的< code > ::< / code > 语法表明< code > new< / code > 是< code > String< / code > 类型的一个< strong > 关联函数< / strong > （ < em > associated function< / em > ）。关联函数是针对类型实现的，在这个例子中是< code > String< / code > ，而不是< code > String< / code > 的某个特定实例。一些语言中把它称为< strong > 静态方法< / strong > （ < em > static method< / em > ）。< / p >
< p > < code > new< / code > 函数创建了一个新的空的< code > String< / code > ，你会在很多类型上发现< code > new< / code > 函数，因为这是创建某个类型新值的常用函数名。< / p >
< p > 总结一下，< code > let mut guess = String::new();< / code > 这一行创建了一个可变变量，目前它绑定到一个< code > String< / code > 新的、空的实例上。哟！< / p >
@ -164,11 +160,11 @@ let mut bar = 5; // mutable
< pre > < code class = "language-rust,ignore" > io::stdin().read_line(& mut guess)
.expect(" Failed to read line" );
< / code > < / pre >
< p > 如果我们在程序的开头没有< code > use std::io< / code > 这一行，我们可以把函数调用写成< code > std::io::stdin< / code > 这样。< code > stdin< / code > 函数返回一个 < a href = " ../std/io/struct.Stdin.html"> < code > std::io::Stdin< / code > < / a > <!-- ignore --> 的实例，这是一个代表终端标准输入句柄的类型。< / p >
< p > 代码的下一部分，< code > .read_line(& mut guess)< / code > ，调用 < a href = " ../std/io/struct.Stdin.html#method.read_line"> < code > read_line< / code > < / a > <!-- ignore --> 方法从标准输入句柄获取用户输入。我们还向< code > read_line()< / code > 传递了一个参数：< code > & mut guess< / code > 。< / p >
< p > 如果我们在程序的开头没有< code > use std::io< / code > 这一行，我们可以把函数调用写成< code > std::io::stdin< / code > 这样。< code > stdin< / code > 函数返回一个 < a href = " https://doc .rust-lang .org /std/io/struct.Stdin.html"> < code > std::io::Stdin< / code > < / a > <!-- ignore --> 的实例，这是一个代表终端标准输入句柄的类型。< / p >
< p > 代码的下一部分，< code > .read_line(& mut guess)< / code > ，调用 < a href = " https://doc .rust-lang .org /std/io/struct.Stdin.html#method.read_line"> < code > read_line< / code > < / a > <!-- ignore --> 方法从标准输入句柄获取用户输入。我们还向< code > read_line()< / code > 传递了一个参数：< code > & mut guess< / code > 。< / p >
< p > < code > read_line< / code > 的工作是把获取任何用户键入到标准输入的字符并放入一个字符串中，所以它获取字符串作为一个参数。这个字符串需要是可变的，这样这个方法就可以通过增加用户的输入来改变字符串的内容。< / p >
< p > < code > & < / code > 表明这个参数是一个< strong > 引用< / strong > （ < em > reference< / em > ），它提供了一个允许多个不同部分的代码访问同一份数据而不需要在内存中多次拷贝的方法。引用是一个复杂的功能，而 Rust 的一大优势就是它是安全而优雅操纵引用。完成这个程序并不需要知道这么多细节：第四章会更全面的解释引用。现在，我们只需知道它像变量一样，默认是不可变的。因此，需要写成< code > & mut guess< / code > 而不是< code > & guess< / code > 来使其可变。< / p >
< p > 这行代码还没有分析完 。虽然这是单独一行代码，但它只是一个逻辑上代码行（虽然换行了但仍是一个语句）的第一部分。第二部分是这个方法：< / p >
< p > < code > & < / code > 表明这个参数是一个< strong > 引用< / strong > （ < em > reference< / em > ），它提供了一个允许多个不同部分的代码访问同一份数据而不需要在内存中多次拷贝的方法。引用是一个复杂的功能，而 Rust 的一大优势就是它是如何 安全而优雅操纵引用的 。完成这个程序并不需要知道这么多细节：第四章会更全面的解释引用。现在，我们只需知道它像变量一样，默认是不可变的。因此，需要写成< code > & mut guess< / code > 而不是< code > & guess< / code > 来使其可变。< / p >
< p > 我们还没有分析完这行代码 。虽然这是单独一行代码，但它只是一个逻辑上代码行（虽然换行了但仍是一个语句）的第一部分。第二部分是这个方法：< / p >
< pre > < code class = "language-rust,ignore" > .expect(" Failed to read line" );
< / code > < / pre >
< p > 当使用< code > .foo()< / code > 语法调用方法时，明智的选择是换行并留出空白（缩进）来把长的代码行拆开。我们可以把代码写成这样：< / p >
@ -176,19 +172,19 @@ let mut bar = 5; // mutable
< / code > < / pre >
< p > 不过，过长的代码行难以阅读，所以最好拆开来写，两行代码两个方法调用。现在来看看这行代码干了什么。< / p >
< a class = "header" href = "#使用result类型来处理潜在的错误" name = "使用result类型来处理潜在的错误" > < h3 > 使用< code > Result< / code > 类型来处理潜在的错误< / h3 > < / a >
< p > 之前提到过，< code > read_line< / code > 将用户输入放入到传递给它字符串中，不过它也返回一个值———— 一个< a href = " ../std/io/type.Result.html"> < code > io::Result< / code > < / a > <!-- ignore --> 。Rust 标准库中有很多叫做< code > Result< / code > 的类型。一个< a href = " ../std/result/enum.Result.html"> < code > Result< / code > < / a > <!-- ignore --> 泛型以及对应子模块的特定版本，比如< code > io::Result< / code > 。< / p >
< p > 之前提到过，< code > read_line< / code > 将用户输入放入到传递给它字符串中，不过它也返回一个值——在这个例子中， 一个< a href = " https://doc .rust-lang .org /std/io/type.Result.html"> < code > io::Result< / code > < / a > <!-- ignore --> 。Rust 标准库中有很多叫做< code > Result< / code > 的类型。一个< a href = " https://doc .rust-lang .org /std/result/enum.Result.html"> < code > Result< / code > < / a > <!-- ignore --> 泛型以及对应子模块的特定版本，比如< code > io::Result< / code > 。< / p >
< p > < code > Result< / code > 类型是 < a href = "ch06-00-enums.html" > < em > 枚举< / em > （ < em > enumerations< / em > ） < / a > <!-- ignore --> ，通常也写作 < em > enums< / em > 。枚举拥有固定值集合的类型，而这些值被称为枚举的< strong > 成员< / strong > （ < em > variants< / em > ）。第六章会更详细的介绍枚举。< / p >
< p > 对于< code > Result< / code > ，它的成员是< code > Ok< / code > 或< code > Err< / code > ， < code > Ok< / code > 表明操作成功了，同时< code > Ok< / code > 成员之中包含成功生成的值。< code > Err< / code > 意味着操作失败，< code > Err< / code > 之中包含操作是为什么或如何失败的信息。< / p >
< p > < code > Result< / code > 类型的作用是编码错误处理信息。< code > Result< / code > 类型的值，正如其他任何类型，拥有定义于其上的方法。< code > io::Result< / code > 的实例拥有< a href = " ../std/result/enum.Result.html#method.expect"> < code > expect< / code > 方法< / a > <!-- ignore --> 可供调用。如果< code > io::Result< / code > 实例的值是< code > Err< / code > ， < code > expect< / code > 会导致程序崩溃并显示显示你作为参数传递给< code > expect< / code > 的信息。如果< code > io::Result< / code > 实例的值是< code > Ok< / code > ， < code > expect< / code > 会获取< code > Ok< / code > 中的值并原原本本的返回给你，这样就可以使用它了。在本例中，返回值是用户输入到标准输入的一些字符 。< / p >
< p > < code > Result< / code > 类型的作用是编码错误处理信息。< code > Result< / code > 类型的值，正如其他任何类型，拥有定义于其上的方法。< code > io::Result< / code > 的实例拥有< a href = " https://doc .rust-lang .org /std/result/enum.Result.html#method.expect"> < code > expect< / code > 方法< / a > <!-- ignore --> 可供调用。如果< code > io::Result< / code > 实例的值是< code > Err< / code > ， < code > expect< / code > 会导致程序崩溃并显示显示你作为参数传递给< code > expect< / code > 的信息。如果< code > io::Result< / code > 实例的值是< code > Ok< / code > ， < code > expect< / code > 会获取< code > Ok< / code > 中的值并原原本本的返回给你。在本例中，这个值是用户输入到标准输入中的字节的数量 。< / p >
< p > 如果不使用< code > expect< / code > ，程序也能编译，不过会出现一个警告：< / p >
< pre > < code class = "language-sh" > $ cargo build
< pre > < code > $ cargo build
Compiling guessing_game v0.1.0 (file:///projects/guessing_game)
src/main.rs:10:5: 10:39 warning: unused result which must be used,
#[warn(unused_must_use)] on by default
src/main.rs:10 io::stdin().read_line(& mut guess);
^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
< / code > < / pre >
< p > Rust 警告说 我们没有使用< code > read_line< / code > 返回的值< code > Result< / code > ，表明程序没有处理一个可能的错误。消除警告的正确方式是老实编写错误处理，不过因为我们仅仅希望程序出现问题就崩溃，可以使用< code > expect< / code > 。你会在 第九章学习从错误中恢复。< / p >
< p > Rust 警告我们没有使用< code > read_line< / code > 返回的值< code > Result< / code > ，表明程序没有处理一个可能的错误。消除警告的正确方式是老实编写错误处理，不过因为我们仅仅希望程序出现问题就崩溃，可以直接 使用< code > expect< / code > 。第九章会 学习从错误中恢复的内容 。< / p >
< a class = "header" href = "#使用println占位符打印值" name = "使用println占位符打印值" > < h3 > 使用< code > println!< / code > 占位符打印值< / h3 > < / a >
< p > 除了位于结尾的大括号，目前为止编写的代码就只有一行代码值得讨论一下了，就是这一行：< / p >
< pre > < code class = "language-rust,ignore" > println!(" You guessed: {}" , guess);
@ -213,8 +209,8 @@ You guessed: 6
< p > 至此为止，游戏的第一部分已经完成：我们从键盘获取了输入并打印了出来。< / p >
< a class = "header" href = "#生成一个秘密数字" name = "生成一个秘密数字" > < h2 > 生成一个秘密数字< / h2 > < / a >
< p > 接下来，需要生成一个秘密数字，用户会尝试猜测它。秘密数字应该每次都不同，这样多玩几次才会有意思。生成一个 1 到 100 之间的随机数这样游戏也不会太难。Rust 标准库中还未包含随机数功能。然而， < a href = "https://crates.io/crates/rand" > < code > rand< / code > crate< / a > 。< / p >
< a class = "header" href = "#使用-crate-来增加更多功能" name = "使用-crate-来增加更多功能" > < h 2> 使用 crate 来增加更多功能< / h2 > < / a >
< p > 记住 < em > crate< / em > 是一个 Rust 代码的包。我们正在构建的项目是一个< strong > 二进制 crate< / strong > ，它生成一个可执行文件。 < code > rand< / code > crate 是一个 < em> 库 crate< / em > ，它包含意在被其他程序使用的代码。< / p >
< a class = "header" href = "#使用-crate-来增加更多功能" name = "使用-crate-来增加更多功能" > < h 3> 使用 crate 来增加更多功能< / h3 > < / a >
< p > 记住 < em > crate< / em > 是一个 Rust 代码的包。我们正在构建的项目是一个< strong > 二进制 crate< / strong > ，它生成一个可执行文件。 < code > rand< / code > crate 是一个 < strong> 库 crate< / strong > ，它包含意在被其他程序使用的代码。< / p >
< p > Cargo 对外部 crate 的运用是其真正闪光的地方。在我们可以使用< code > rand< / code > 编写代码之前，需要编辑 < em > Cargo.toml< / em > 来包含< code > rand< / code > 作为一个依赖。现在打开这个文件并在< code > [dependencies]< / code > 部分标题（ < / p >
< p > < span class = "filename" > Filename: Cargo.toml< / span > < / p >
< pre > < code class = "language-toml" > [dependencies]
@ -222,9 +218,8 @@ You guessed: 6
rand = " 0.3.14"
< / code > < / pre >
< p > 在 < em > Cargo.toml< / em > 文件中，任何标题之后的内容都是属于这个部分的，一直持续到直到另一个部分开始。< code > [dependencies]< / code > 部分告诉 Cargo 项目依赖了哪个外部 crate 和需要的 crate 版本。在这个例子中，我们使用语义化版本符号< code > 0.3.14< / code > 来指定< code > rand< / code > crate。Cargo 理解< a href = "http://semver.org" > 语义化版本（ ） < / a > <!-- ignore --> （有时也称为 < em > SemVer< / em > ），这是一个编写版本号的标准。版本号< code > 0.3.14< / code > 事实上是< code > ^0.3.14< / code > 的缩写，它的意思是“任何与 0.3.14 版本公有 API 相兼容的版本”。< / p >
< p > 现在，不用修改任何代码，构建项目，如列表 2-2： < / p >
< figure >
< pre > < code class = "language-text" > $ cargo build
< p > 现在，不用修改任何代码，构建项目，如列表 2-2 所示：< / p >
< pre > < code > $ cargo build
Updating registry `https://github.com/rust-lang/crates.io-index`
Downloading rand v0.3.14
Downloading libc v0.2.14
@ -232,21 +227,18 @@ rand = "0.3.14"
Compiling rand v0.3.14
Compiling guessing_game v0.1.0 (file:///projects/guessing_game)
< / code > < / pre >
< figcaption >
< p > Listing 2-2: The output from running < code > cargo build< / code > after adding the rand crate
as a dependency< / p >
< / figcaption >
< / figure >
< p > < span class = "caption" > Listing 2-2: The output from running < code > cargo build< / code > after
adding the rand crate as a dependency< / span > < / p >
< p > 可能会出现不同的版本号（不过多亏了语义化版本，它们与代码是兼容的！），同时显示顺序也可能会有所不同。< / p >
< p > 现在我们有了一个外部依赖， < em > registry< / em > （ < a href = "https://crates.io" > Crates.io< / a > ） （ ） 人 们向他人贡献他们的开源 Rust 项目的地方。< / p >
< p > 在更新完 registry （ ） ， < code > [dependencies]< / code > 部分并下载还不存在部分。在这个例子中，虽然只列出了< code > rand< / code > 一个依赖， < code > libc< / code > 的拷贝，因为< code > rand< / code > 依赖< code > libc< / code > 来正常工作。在下载他们之后， < / p >
< p > 现在我们有了一个外部依赖， < em > registry< / em > （ < a href = "https://crates.io" > Crates.io< / a > ） （ ） < / p >
< p > 在更新完 registry （ ） ， < code > [dependencies]< / code > 部分并下载还不存在的部分。在这个例子中，虽然只列出了< code > rand< / code > 一个依赖， < code > libc< / code > 的拷贝，因为< code > rand< / code > 依赖< code > libc< / code > 来正常工作。在下载他们之后， < / p >
< p > 如果不做任何修改就立刻再次运行< code > cargo build< / code > ， < em > Cargo.toml< / em > 文件中也没有任何相关修改。Cargo 也知道代码没有做任何修改，所以它也不会重新编译代码。因为无事可做，它简单的退出了。如果打开 < em > src/main.rs< / em > 文件，并做一些普通的修改，保存并再次构建，只会出现一行输出：< / p >
< pre > < code class = "language-sh" > $ cargo build
< pre > < code > $ cargo build
Compiling guessing_game v0.1.0 (file:///projects/guessing_game)
< / code > < / pre >
< p > 这一行表明 Cargo 只构建了对 < em > src/main.rs< / em > 文件做出的微小修改。依赖没有被修改，所以 Cargo 知道可以复用已经为此下载并编译的代码。它只是重新构建了部分（项目）代码。< / p >
< a class = "header" href = "# the- cargolock-文件确保构建是可重现的" name = " the- cargolock-文件确保构建是可重现的"> < h4 > The < em > Cargo.lock< / em > 文件确保构建是可重现的< / h4 > < / a >
< p > Cargo 有一个机制来确保每次任何人重新构建代码都会生成相同的成品 ： < code > rand< / code > crate 的< code > v0.3.15< / code > 版本出来了，而它包含一个重要的 bug 修改并也含有一个会破坏代码运行的缺陷的时候会发生什么呢？< / p >
< a class = "header" href = "# cargolock-文件确保构建是可重现的" name = " cargolock-文件确保构建是可重现的"> < h4 > < em > Cargo.lock< / em > 文件确保构建是可重现的< / h4 > < / a >
< p > Cargo 有一个机制来确保每次任何人重新构建代码都会生成相同的结果 ： < code > rand< / code > crate 的< code > v0.3.15< / code > 版本出来了，而它包含一个重要的 bug 修改并也含有一个会破坏代码运行的缺陷的时候会发生什么呢？< / p >
< p > 这个问题的答案是 < em > Cargo.lock< / em > 文件，它在第一次运行< code > cargo build< / code > 时被创建并位于 < em > guessing_game< / em > 目录。当第一次构建项目时， < em > Cargo.lock< / em > 文件中。当将来构建项目时， < em > Cargo.lock< / em > 存在就会使用这里指定的版本，而不是重新进行所有版本的计算。这使得你拥有了一个自动的可重现的构建。换句话说，项目会继续使用< code > 0.3.14< / code > 直到你显式升级，多亏了 < em > Cargo.lock< / em > 文件。我们将会在这个文件编写全部的代码。< / p >
< a class = "header" href = "#更新-crate-到一个新版本" name = "更新-crate-到一个新版本" > < h4 > 更新 crate 到一个新版本< / h4 > < / a >
< p > 当你< strong > 确实< / strong > 需要升级 crate 时， < code > update< / code > ，他会：< / p >
@ -255,7 +247,7 @@ as a dependency</p>
< li > 如果成功了， < em > Cargo.lock< / em > 文件。< / li >
< / ol >
< p > 不过， < code > 0.3.0< / code > 而小于< code > 0.4.0< / code > 的版本。如果< code > rand< / code > crate 发布了两个新版本，< code > 0.3.15< / code > 和< code > 0.4.0< / code > ，在运行< code > cargo update< / code > 时会出现如下内容：< / p >
< pre > < code class = "language-sh" > $ cargo update
< pre > < code > $ cargo update
Updating registry `https://github.com/rust-lang/crates.io-index`
Updating rand v0.3.14 -> v0.3.15
< / code > < / pre >
@ -268,9 +260,8 @@ rand = "0.4.0"
< p > 下一次运行< code > cargo build< / code > 时， < code > rand< / code > 的要求。< / p >
< p > 第十四章会讲到< a href = "http://doc.crates.io" > Cargo< / a > <!-- ignore --> 和< a href = "http://doc.crates.io/crates-io.html" > 它的生态系统< / a > <!-- ignore --> 的更多内容， < / p >
< a class = "header" href = "#生成一个随机数" name = "生成一个随机数" > < h3 > 生成一个随机数< / h3 > < / a >
< p > 让我们开始< strong > 使用< / strong > < code > rand< / code > 。下一步是更新 < em > src/main.rs< / em > ，如列表 2-3： < / p >
< figure >
< span class = "filename" > Filename: src/main.rs< / span >
< p > 让我们开始< strong > 使用< / strong > < code > rand< / code > 。下一步是更新 < em > src/main.rs< / em > ，如列表 2-3 所示：< / p >
< p > < span class = "filename" > Filename: src/main.rs< / span > < / p >
< pre > < code class = "language-rust,ignore" > extern crate rand;
use std::io;
@ -293,17 +284,15 @@ fn main() {
println!(" You guessed: {}" , guess);
}
< / code > < / pre >
< figcaption >
< p > Listing 2-3: Code changes needed in order to generate a random number< / p >
< / figcaption >
< / figure >
< p > < span class = "caption" > Listing 2-3: Code changes needed in order to generate a
random number< / span > < / p >
< p > 我们在顶部增加一行< code > extern crate rand;< / code > 来让 Rust 知道我们要使用外部依赖。这也会调用相应的< code > use rand< / code > ，所以现在可以使用< code > rand::< / code > 前缀来调用< code > rand< / code > 中的任何内容。< / p >
< p > 接下来，我们增加了另一行< code > use< / code > ： < code > use rand::Rng< / code > 。< code > Rng< / code > 是一个定义了随机数生成器应实现方法的 trait， < / p >
< p > 另外，中间还新增加了两行。< code > rand::thread_rng< / code > 函数会提供具体会使用的随机数生成器：它位于当前执行线程本地并从操作系统获取 seed。接下来， < code > gen_range< / code > 方法。这个方法由我们使用< code > use rand::Rng< / code > 语句引入到作用域的< code > Rng< / code > trait 定义。< code > gen_range< / code > 方法获取两个数作为参数并生成一个两者之间的随机数。它包含下限但不包含上限，所以需要指定< code > 1< / code > 和< code > 101< / code > 来请求一个< code > 1< / code > 和< code > 100< / code > 之间的数。< / p >
< p > 并不仅仅能够知道该 use 哪个 trait 和该从 crate 中调用哪个方法。如何使用 crate 的说明在 每个 crate 的文档中。Cargo 另一个很棒的功能是可以运行< code > cargo doc --open< / code > 命令来构建所有本地依赖提供的文档并在浏览器中打开。例如，如果你对< code > rand< / code > crate 中的其他功能感兴趣，运行< code > cargo doc --open< / code > 并点击左侧导航栏的< code > rand< / code > 。< / p >
< p > 并不是 仅仅能够< strong > < / strong > 位于 每个 crate 的文档中。Cargo 另一个很棒的功能是可以运行< code > cargo doc --open< / code > 命令来构建所有本地依赖提供的文档并在浏览器中打开。例如，如果你对< code > rand< / code > crate 中的其他功能感兴趣，运行< code > cargo doc --open< / code > 并点击左侧导航栏中 的< code > rand< / code > 。< / p >
< p > 新增加的第二行代码打印出了秘密数字。这在开发程序时很有用，因为我们可以去测试它，不过在最终版本我们会删掉它。游戏一开始就打印出结果就没什么可玩的了！< / p >
< p > 尝试运行程序几次：< / p >
< pre > < code class = "language-sh" > $ cargo run
< pre > < code > $ cargo run
Compiling guessing_game v0.1.0 (file:///projects/guessing_game)
Running `target/debug/guessing_game`
Guess the number!
@ -321,9 +310,8 @@ You guessed: 5
< / code > < / pre >
< p > 你应该能得到不同的随机数，同时他们应该都是在 1 和 100 之间的。干得漂亮！< / p >
< a class = "header" href = "#比较猜测与秘密数字" name = "比较猜测与秘密数字" > < h2 > 比较猜测与秘密数字< / h2 > < / a >
< p > 现在有了用户输入和一个随机数，我们可以比较他们。这个步骤如列表 2-4： < / p >
< figure >
< span class = "filename" > Filename: src/main.rs< / span >
< p > 现在有了用户输入和一个随机数，我们可以比较他们。这个步骤如列表 2-4 所示：< / p >
< p > < span class = "filename" > Filename: src/main.rs< / span > < / p >
< pre > < code class = "language-rust,ignore" > extern crate rand;
use std::io;
@ -353,10 +341,8 @@ fn main() {
}
}
< / code > < / pre >
< figcaption >
< p > Listing 2-4: Handling the possible return values of comparing two numbers< / p >
< / figcaption >
< / figure >
< p > < span class = "caption" > Listing 2-4: Handling the possible return values of
comparing two numbers< / span > < / p >
< p > 新代码的第一行是另一个< code > use< / code > ，从标准库引入了一个叫做< code > std::cmp::Ordering< / code > 的类型到作用域。< code > Ordering< / code > 是另一个枚举，像< code > Result< / code > 一样，不过< code > Ordering< / code > 的成员是< code > Less< / code > 、< code > Greater< / code > 和< code > Equal< / code > 。这是你比较两个值时可能出现三种结果。< / p >
< p > 接着在底部的五行新代码使用了< code > Ordering< / code > 类型：< / p >
< pre > < code class = "language-rust,ignore" > match guess.cmp(& secret_number) {
@ -366,10 +352,10 @@ fn main() {
}
< / code > < / pre >
< p > < code > cmp< / code > 方法比较两个值并可以在任何可比较的值上调用。它获取一个任何你想要比较的值的引用：这里是把< code > guess< / code > 与< code > secret_number< / code > 做比较。< code > cmp< / code > 返回一个使用< code > use< / code > 语句引入作用域的< code > Ordering< / code > 枚举的成员。我们使用一个< a href = "ch06-02-match.html" > < code > match< / code > < / a > <!-- ignore --> 表达式根据对< code > guess< / code > 和< code > secret_number< / code > 中的值调用< code > cmp< / code > 后返回的哪个< code > Ordering< / code > 枚举成员来决定接下来干什么。< / p >
< p > 一个< code > match< / code > 表达式由 < strong > 分支（ ） < / strong > 构成。一个分支包含一个 < strong > 模式< / strong > （ < em > pattern< / em > ）和代码，这些代码在< code > match< / code > 表达式开头给出的值符合分支的模式时将被执行。Rust 获取提供给< code > match< / code > 的值并挨个检查每个分支的模式。< code > match< / code > 结构和模式是 Rust 中非常强大的功能，它帮助你体现代码可能遇到的多种情形并帮助你处理全部的可能。这些功能将分别在第六章和第十九 章详细介绍。< / p >
< p > 一个< code > match< / code > 表达式由 < strong > 分支（ ） < / strong > 构成。一个分支包含一个 < strong > 模式< / strong > （ < em > pattern< / em > ）和代码，这些代码在< code > match< / code > 表达式开头给出的值符合分支的模式时将被执行。Rust 获取提供给< code > match< / code > 的值并挨个检查每个分支的模式。< code > match< / code > 结构和模式是 Rust 中非常强大的功能，它帮助你体现代码可能遇到的多种情形并帮助你处理全部的可能。这些功能将分别在第六章和第十八 章详细介绍。< / p >
< p > 让我们看看一个使用这里的< code > match< / code > 表达式会发生什么的例子。假设用户猜了 50， < code > cmp< / code > 方法会返回< code > Ordering::Greater< / code > ，因为 50 比 38 要大。< code > Ordering::Greater< / code > 是< code > match< / code > 表达式得到的值。它检查第一个分支的模式，< code > Ordering::Less< / code > ，不过值< code > Ordering::Greater< / code > 并不匹配< code > Ordering::Less< / code > 。所以它忽略了这个分支的代码并移动到下一个分支。下一个分支的模式，< code > Ordering::Greater< / code > ， < strong > 正确< / strong > 匹配了< code > Ordering::Greater< / code > ！这个分支关联的代码会被执行并在屏幕打印出< code > Too big!< / code > 。< code > match< / code > 表达式就此终止，因为在这个特定场景下没有检查最后一个分支的必要。< / p >
< p > 然而，列表 2-4 的代码并不能编译，尝试一下：< / p >
< pre > < code class = "language-sh" > $ cargo build
< p > 然而，列表 2-4 的代码并不能编译，可以 尝试一下：< / p >
< pre > < code > $ cargo build
Compiling guessing_game v0.1.0 (file:///projects/guessing_game)
error[E0308]: mismatched types
--> src/main.rs:23:21
@ -383,7 +369,7 @@ error[E0308]: mismatched types
error: aborting due to previous error
Could not compile `guessing_game`.
< / code > < / pre >
< p > 错误的核心表明这里有< strong > 不匹配的类型< / strong > （ < em > mismatched types< / em > ） < code > let guess = String::new()< / code > 时， < code > guess< / code > 应该是一个< code > String< / code > ，并不需要我们写出类型。另一方面，< code > secret_number< / code > ，是一个数字类型。一些数字类型拥有 1 到 100 之间的值：< code > i32< / code > ，一个 32 位的数字；< code > u32< / code > ，一个 32 位无符号数字；< code > i64< / code > ，一个 64 位数字； < code > i32< / code > ，所以< code > secret_number< / code > 的类型就是它，除非增加类型信息或任何能让 Rust 推断出不同数值类型的信息。这里错误的原因是 Rust 不会比较字符串类型和数字类型。< / p >
< p > 错误的核心表明这里有< strong > 不匹配的类型< / strong > （ < em > mismatched types< / em > ） < code > let guess = String::new()< / code > 时， < code > guess< / code > 应该是一个< code > String< / code > ，并不需要我们写出类型。另一方面，< code > secret_number< / code > ，是一个数字类型。一些数字类型拥有 1 到 100 之间的值：< code > i32< / code > ，一个 32 位的数字；< code > u32< / code > ，一个 32 位无符号数字；< code > i64< / code > ，一个 64 位数字； < code > i32< / code > ，所以< code > secret_number< / code > 的类型就是它，除非增加类型信息或任何能让 Rust 推断出不同数值类型的信息。这里错误的原因在于 Rust 不会比较字符串类型和数字类型。< / p >
< p > 最终我们想要把程序从输入中读取到的< code > String< / code > 转换为一个真正的数字类型，这样好与秘密数字向比较。可以通过在< code > main< / code > 函数体中增加如下两行代码来实现：< / p >
< p > < span class = "filename" > Filename: src/main.rs< / span > < / p >
< pre > < code class = "language-rust,ignore" > extern crate rand;
@ -424,10 +410,10 @@ fn main() {
< / code > < / pre >
< p > 这里创建了一个叫做< code > guess< / code > 的变量。不过等等，难道这个程序不是已经有了一个叫做< code > guess< / code > 的变量了吗？确实如此，不过 Rust 允许我们通过< strong > 覆盖< / strong > （ < em > shadow< / em > ） < code > guess< / code > 之前的值。这个功能经常用在类似需要把一个值从一种类型转换到另一种类型的场景。shadowing 允许我们复用< code > guess< / code > 变量的名字而不是强迫我们创建两个不同变量，比如< code > guess_str< / code > 和< code > guess< / code > 。（第三章会介绍 shadowing 的更多细节。）< / p >
< p > < code > guess< / code > 被绑定到< code > guess.trim().parse()< / code > 表达式。表达式中的< code > guess< / code > 对应包含输入的< code > String< / code > 类型的原始< code > guess< / code > 。< code > String< / code > 实例的< code > trim< / code > 方法会消除字符串开头和结尾的空白。< code > u32< / code > 只能包含数字字符。不过用户必须输入回车键才能让< code > read_line< / code > 返回。当用户按下回车键时， （ ） ， < code > guess< / code > 看起来像这样：< code > 5\n< / code > 。< code > \n< / code > 代表“换行”，回车键。< code > trim< / code > 方法消除< code > \n< / code > ，只留下< code > 5< / code > 。< / p >
< p > < a href = " ../std/primitive.str.html#method.parse"> 字符串的< code > parse< / code > 方法< / a > <!-- ignore --> 解析一个字符串成某个数字。因为这个方法可以解析多种数字类型，需要告诉 Rust 我们需要的具体的数字类型，这里通过< code > let guess: u32< / code > 指定。< code > guess< / code > 后面的冒号（< code > :< / code > ）告诉 Rust 我们指明了变量的类型。Rust 有一些内建的数字类型；这里的< code > u32< / code > 是一个无符号的 32 位整型。它是一个好的较小正整数的默认类型。第三章会讲到其他数字类型。另外，例子程序中的< code > u32< / code > 注解和与< code > secret_number< / code > 的比较意味着 Rust 会推断< code > secret_number< / code > 应该是也是< code > u32< / code > 类型。现在可以使用相同类型比较两个值了！< / p >
< p > < code > parse< / code > 调用容易产生错误。例如，如果字符串包含< code > A👍%< / code > ，就无法将其转换为一个数字。因为它可能失败，< code > parse< / code > 方法返回一个< code > Result< / code > 类型，非常像之前在 XX 页 “使用< code > Result< / code > 类型来处理潜在的错误”部分讨论的< code > read_line< / code > 方法。这里再次类似的使用< code > expect< / code > 方法处理这个< code > Result< / code > 类型。如果< code > parse< / code > 因为不能从字符串生成一个数字而返回一个< code > Err< / code > 的< code > Result< / code > 成员时，< code > expect< / code > 会使游戏崩溃并打印提供给它的信息。如果< code > parse< / code > 能成功地将字符串转换为一个数字，它会返回< code > Result< / code > 的< code > Ok< / code > 成员，同时< code > expect< / code > 会返回< code > Ok< / code > 中我们需要的数字。< / p >
< p > < a href = " https://doc .rust-lang .org /std/primitive.str.html#method.parse"> 字符串的< code > parse< / code > 方法< / a > <!-- ignore --> 解析一个字符串成某个数字。因为这个方法可以解析多种数字类型，需要告诉 Rust 我们需要的具体的数字类型，这里通过< code > let guess: u32< / code > 指定。< code > guess< / code > 后面的冒号（< code > :< / code > ）告诉 Rust 我们指明了变量的类型。Rust 有一些内建的数字类型；这里的< code > u32< / code > 是一个无符号的 32 位整型。它是一个好的较小正整数的默认类型。第三章会讲到其他数字类型。另外，例子程序中的< code > u32< / code > 注解和与< code > secret_number< / code > 的比较意味着 Rust 会推断< code > secret_number< / code > 应该是也是< code > u32< / code > 类型。现在可以使用相同类型比较两个值了！< / p >
< p > < code > parse< / code > 调用容易产生错误。例如，如果字符串包含< code > A👍%< / code > ，就无法将其转换为一个数字。因为它可能失败，< code > parse< / code > 方法返回一个< code > Result< / code > 类型，非常像之前在“使用< code > Result< / code > 类型来处理潜在的错误”部分讨论的< code > read_line< / code > 方法。这里再次类似的使用< code > expect< / code > 方法处理这个< code > Result< / code > 类型。如果< code > parse< / code > 因为不能从字符串生成一个数字而返回一个< code > Err< / code > 的< code > Result< / code > 成员时，< code > expect< / code > 会使游戏崩溃并打印提供给它的信息。如果< code > parse< / code > 能成功地将字符串转换为一个数字，它会返回< code > Result< / code > 的< code > Ok< / code > 成员，同时< code > expect< / code > 会返回< code > Ok< / code > 中我们需要的数字。< / p >
< p > 现在让我们运行程序！< / p >
< pre > < code class = "language-sh" > $ cargo run
< pre > < code > $ cargo run
Compiling guessing_game v0.1.0 (file:///projects/guessing_game)
Running `target/guessing_game`
Guess the number!
@ -477,8 +463,8 @@ fn main() {
}
< / code > < / pre >
< p > 如上所示，我们将提示用户猜测之后的所有内容放入了循环。确保这些代码多缩进了四个空格，并再次运行程序。注意这里有一个新问题，因为程序忠实地执行了我们要求它做的：永远地请求另一个猜测！看起来用户没法退出啊！< / p >
< p > 用户总是可以使用< code > Ctrl-C< / code > 快捷键来终止程序。不过这里还有另一个逃离这个贪得无厌的怪物的方法，就是在 XX 页 “比较猜测”部分提到的< code > parse< / code > ：如果用户输入一个非数字回答，程序会崩溃。用户可以利用这一点来退出，如下所示：< / p >
< pre > < code class = "language-sh" > $ cargo run
< p > 用户总是可以使用< code > Ctrl-C< / code > 快捷键来终止程序。不过这里还有另一个逃离这个贪得无厌的怪物的方法，就是在“比较猜测”部分提到的< code > parse< / code > ：如果用户输入一个非数字回答，程序会崩溃。用户可以利用这一点来退出，如下所示：< / p >
< pre > < code > $ cargo run
Compiling guessing_game v0.1.0 (file:///projects/guessing_game)
Running `target/guessing_game`
Guess the number!
@ -501,7 +487,7 @@ thread 'main' panicked at 'Please type a number!: ParseIntError { kind: InvalidD
note: Run with `RUST_BACKTRACE=1` for a backtrace.
error: Process didn't exit successfully: `target/debug/guess` (exit code: 101)
< / code > < / pre >
< p > 输入< code > quit< / code > 就会退出 程序，同时其他任何非数字输入也一样。然而，毫不夸张的说这是不理想的。我们想要当猜测正确的数字时游戏能自动退出。< / p >
< p > 输入< code > quit< / code > 确实退出了 程序，同时其他任何非数字输入也一样。然而，毫不夸张的说这是不理想的。我们想要当猜测正确的数字时游戏能自动退出。< / p >
< a class = "header" href = "#猜测正确后退出" name = "猜测正确后退出" > < h3 > 猜测正确后退出< / h3 > < / a >
< p > 让我们增加一个< code > break< / code > 来在用户胜利时退出游戏：< / p >
< p > < span class = "filename" > Filename: src/main.rs< / span > < / p >
@ -554,7 +540,7 @@ fn main() {
< p > 如果< code > parse< / code > 能够成功的将字符串转换为一个数字，它会返回一个包含结果数字< code > Ok< / code > 值。这个< code > Ok< / code > 值会匹配第一个分支的模式，这时< code > match< / code > 表达式仅仅返回< code > parse< / code > 产生的< code > Ok< / code > 值之中的< code > num< / code > 值。这个数字会最终如期变成新创建的< code > guess< / code > 变量。< / p >
< p > 如果< code > parse< / code > < em > 不< / em > 能将字符串转换为一个数字，它会返回一个包含更多错误信息的< code > Err< / code > 值。< code > Err< / code > 值不能匹配第一个< code > match< / code > 分支的< code > Ok(num)< / code > 模式，但是会匹配第二个分支的< code > Err(_)< / code > 模式。< code > _< / code > 是一个包罗万象的值；在这个例子中，我们想要匹配所有< code > Err< / code > 值，不管其中有何种信息。所以程序会执行第二个分支的代码，< code > continue< / code > ，这意味着进入< code > loop< / code > 的下一次循环并请求另一个猜测。这样程序就有效地忽略了< code > parse< / code > 可能遇到的所有错误！< / p >
< p > 现在万事俱备（只欠东风）了。运行< code > cargo run< / code > 来尝试一下：< / p >
< pre > < code class = "language-sh" > $ cargo run
< pre > < code > $ cargo run
Compiling guessing_game v0.1.0 (file:///projects/guessing_game)
Running `target/guessing_game`
Guess the number!
@ -575,8 +561,7 @@ You guessed: 61
You win!
< / code > < / pre >
< p > 太棒了！再有最后一个小的修改，就能完成猜猜看游戏了：还记得程序依然会打印出秘密数字。这在测试时还好，但会毁了游戏性。删掉打印秘密数字的< code > println!< / code > 。列表 2-5 为最终代码：< / p >
< figure >
< span class = "filename" > Filename: src/main.rs< / span >
< p > < span class = "filename" > Filename: src/main.rs< / span > < / p >
< pre > < code class = "language-rust,ignore" > extern crate rand;
use std::io;
@ -614,13 +599,10 @@ fn main() {
}
}
< / code > < / pre >
< figcaption >
< p > Listing 2-5: Complete code of the guessing game< / p >
< / figcaption >
< / figure >
< a class = "header" href = "#总结一下" name = "总结一下" > < h2 > 总结一下，< / h2 > < / a >
< p > < span class = "caption" > Listing 2-5: Complete code of the guessing game< / span > < / p >
< a class = "header" href = "#总结" name = "总结" > < h2 > 总结< / h2 > < / a >
< p > 此时此刻，你顺利完成了猜猜看游戏！恭喜！< / p >
< p > 这是一个通过动手实践的方式想你介绍许多 Rust 新知识的项目：< code > let< / code > 、< code > match< / code > 、方法、关联函数，使用外部 crate， ， ， ， （ ） ， < / p >
< p > 这是一个通过动手实践的方式想你介绍许多 Rust 新知识的项目：< code > let< / code > 、< code > match< / code > 、方法、关联函数，使用外部 crate， ， ， ， （ ） ， < / p >
< / div >
KaiserY
8 years ago