rust 初探 -- use

rust 初探 – use

Package, Crate, 定义 Module

use 关键字

作用：将路径引入到作用域内，其依旧遵循私有性规则，也即只用 pub 的部分引入进来才能使用

use crate::front_of_house::hosting; // 绝对路径
// use front_of_house::hosting; // 效果是一样的（相对路径）

mod front_of_house {
    pub mod hosting {
        pub fn add_to_waitlist() {}
    }
}

pub fn eat_at_restaurant() {
    hosting::add_to_waitlist();
}
// 引入可以到任意层级，包括函数层级，但是一般不这么使用，避免冲突，并保证代码的可读性

use 的习惯用法

• 函数：将函数的父级模块引入作用域（指定到父级）
• struct，enum，其它：指定完整路径

use std::collections::HashMap;

fn main() {
    let mut map = HashMap::new();
    map.insert(1, 2);
}

• 同名条目：指定到父级

use std::fmt;
use std::io;

fn f1() -> fmt::Result {}
fn f2() -> io::Result {}

• as 关键字

use std::fmt::Result;
use std::io::Result as io_result;

fn f1() -> Result {}
fn f2() -> io_result {}

pub use：重新导出名称

• 使用 use 将路径导入到作用域内后，该名称在此作用域内是私有的

// use crate::front_of_house::hosting; // 外部不可访问
pub use crate::front_of_house::hosting; // 外部可访问

mod front_of_house {
    pub mod hosting {
        pub fn add_to_waitlist() {}
    }
}

pub fn eat_at_restaurant() {
    hosting::add_to_waitlist();
}

使用外部包（packege）

1. Cargo.toml 添加依赖的包：dependencies 下添加需要的包（https://crates.io/）
2. use 将特定条目引入作用域

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

[dependencies]
rand = "0.8.5"
// 2. use 将特定条目引入作用域
use rand::Rng;
use rand::thread_rng;

fn main() {
    let mut rng = thread_rng();
    let x: u32 = rng.gen();
    println!("{}", x);
}

• 标准库也被当作外部包，需要使用 use::std 引入使用

使用嵌套路径清理大量的 use 语句

如果使用同一个包或模块下的多个条目，可以使用嵌套路径在同一行内将所有条目进行引入

use std::cmp;
use std::io;

// use std::{cmp, io};	//同一行，将所有条目进行引入
// use std::cmp::{self, Ordering}; //如果其中一个是子路径，那么可以使用 self

通配符

使用 * 可以把路径下所有的公共条目都引入到作用域

use std::collections::*; //一般在测试文件中这样写，不建议直接这样写

将模块拆分为不同的文件

当模块名后面带的是 ; ，那么 rust 会在 src 目录下查找 同名的 .rs 文件，如果是嵌套的模块，会在和嵌套模块同名的 src/mod_name 目录下查找同名的 .rs 文件。如下所示：

mod front_of_house {
	pub mod hosting {
		pub fn add() {}
	} 
}

拆分后是：

// /src/main.rs:
mod front_of_house; 
fn main() {}

// /src/front_of_house.rs
pub mod hosting;

// /src/front_of_house/hosting.rs
pub fn add() {}

随着模块逐渐变大，可以把模块的内容移动到其他文件中。