rust入门学习-猜数字游戏

代码

// 默认情况下，Rust会将少量标准库中定义的程序项（item）引入到每个程序的作用域中。这些项称作 prelude
// 如果需要的类型不在 prelude 中，使用 use 语句显式地将其引入作用域
use rand::Rng;
use std::cmp::Ordering;
use std::io;

fn main() {
    println!("Guess the number!");
    // 变量默认不可变
	// 调用 rand::thread_rng 函数提供将要使用的特定随机数生成器
	// 它位于当前执行线程的本地环境中，并从操作系统获取 seed
	// 然后调用随机数生成器的 gen_range 方法
	// 该方法由刚才使用 use rand::Rng 语句引入的 Rng trait 定义
    let secret_number = rand::thread_rng().gen_range(1..101);

    loop {
        println!("Please input your guess.");
		// 在变量名前使用 mut 来使一个变量可变
		// 返回一个 String 的新实例，UTF-8 编码的可增长文本块
		// :: 语法表明 new 是 String 类型的一个关联函数，创建一个新的空串
        let mut guess = String::new();
	
		// stdin 函数返回一个 std::io::Stdin 的实例，即终端标准输入句柄类型
		// 将 &mut guess 作参数传递给 read_line()，告诉存储用户输入的地址
		// Rust 的一个主要优势就是安全而简单的操作引用
		// read_line返回值io::Result，枚举类型，枚举与条件表达式 match配合使用
		// Result 的成员是 Ok 和 Err
		// Ok 成员表示操作成功，内部包含成功时产生的值
		// Err 成员则意味着操作失败，并且包含失败的前因后果
		// Result 类型的值，拥有定义于其上的方法
		// io::Result 的实例拥有 expect 方法
		// 如果 io::Result 实例的值是 Err，expect 会导致程序崩溃
		// 并显示当做参数传递给 expect 的信息
		// 如果 io::Result 实例的值是 Ok，expect 会获取 Ok 中的值并原样返回
        io::stdin()
            .read_line(&mut guess)
            .expect("Failed to read line");

		// Rust 有一个静态强类型系统，同时也有类型推断
		// Rust 默认使用 i32
		// 额外指定类型，或让 Rust 推断出类型
		// Rust 允许用一个新值来遮蔽 （shadow） guess 之前的值
		// 
		// String 实例的 trim 方法会去除字符串开头和结尾的空白字符
		// 举例：用户输入 5 并按下 enter，guess 看起来像这样：5\n
		// 
		// parse 方法返回一个 Result 类型
		// _ 是一个通配符值，当输入一个不是数字的值时，继续continue
        let guess: u32 = match guess.trim().parse() {
            Ok(num) => num,
            Err(_) => continue,
        };

        println!("You guessed: {}", guess);

		// Ordering 是一个枚举，不过它的成员是 Less、Greater 和 Equal
        match guess.cmp(&secret_number) {
            Ordering::Less => println!("Too small!"),
            Ordering::Greater => println!("Too big!"),
            Ordering::Equal => {
                println!("You win!");
                break;
            }
        }
    }
}

依赖包

手动添加 rand = “0.8.3”
0.8.3 实际上是 ^0.8.3 的简写
它表示任何至少包含 0.8.3 但低于 0.9.0 的版本

Cargo 认为这些版本具有与 0.8.3 版本兼容的公有 API，
并且此规范可确保将获得最新的补丁版本，它仍然可以与本章中的代码正常编译
0.9.0 或更高版本则不再确保 API 和以下示例所使用的 API 相同

当引入了一个外部依赖后，Cargo 将从 registry 上获取所有依赖所需的最新版本
这是一份来自 Crates.io 的数据拷贝
Crates.io 是 Rust 生态环境中开发者们向他人贡献 Rust 开源项目的地方

cat Cargo.toml
[package]
name = "hello_cargo"
version = "0.1.0"
edition = "2021"

[dependencies]
rand = "0.8.3"

【执行依赖包的构建】

cargo build

虽然只声明了 rand 一个依赖，然而 Cargo 还是额外获取了 rand 所需的其他 crate，rand 依赖它们来正常工作。
下载完成后，Rust 编译依赖，然后使用这些依赖编译项目

Cargo 有一个机制来确保任何人在任何时候重新构建代码，都会产生相同的结果：
Cargo 只会使用指定的依赖版本，除非又手动指定了别的。
例如，如果下周 rand crate 的 0.8.4 版本出来了，它修复了一个重要的 bug，同时也含有一个会破坏代码运行的缺陷。为了处理这个问题，Rust 在第一次运行 cargo build 时建立了 Cargo.lock 文件。

当第一次构建项目时，Cargo 计算出所有符合要求的依赖版本并写入 Cargo.lock 文件。
当将来构建项目时，Cargo 会发现 Cargo.lock 已存在并使用其中指定的版本
而不是再次计算所有的版本。
这使得项目拥有了一个自动化的可重现的构建。
换句话说，项目会持续使用 0.8.3 直到显式升级

【更新 crate 到一个新版本】
当需要升级 crate 时，update命令忽略 Cargo.lock 文件，并计算出所有符合 Cargo.toml 声明的最新版本。Cargo 接下来会把这些版本写入 Cargo.lock 文件。
Cargo 默认只会寻找大于或等于 0.8.3 而小于 0.9.0 的版本。如果 rand crate 发布了两个新版本，0.8.4 和 0.9.0，在运行 cargo update 时会出现如下内容：

cargo update
    Updating crates.io index
    Updating rand v0.8.3 -> v0.8.4

Cargo 忽略了 0.9.0 版本。
Cargo.lock 文件中发生了更改， and crate 版本改为 0.8.4
如果想要 rand 使用 0.9.0 版本或任何 0.9.x 系列的版本，则必须像这样更新 Cargo.toml 文件：

[dependencies]
rand = "0.9.0"

下一次运行 cargo build 时，Cargo 会从 registry（注册源） 更新可用的 crate，并根据指定的新版本重新计算。

查找依赖包的功能

构建所有本地依赖提供的文档，并在浏览器中打开
cargo doc --open