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)
- Cargo.toml 添加依赖的包:dependencies 下添加需要的包(https://crates.io/)
- 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() {}
随着模块逐渐变大,可以把模块的内容移动到其他文件中。