Rust 编程视频教程对应讲解内容－包、crate、模块

视频地址

头条地址：https://www.ixigua.com/i6765442674582356483
Ｂ站地址：https://www.bilibili.com/video/av78062009?p=1
网易云课堂地址：https://study.163.com/course/introduction.htm?courseId=1209596906#/courseDetail?tab=1

讲解内容

1、定义
（1）包：Cargo的一个功能，允许构建、测试和分享crate。
（2）Crate：一个模块的树形结构，形成库或二进制项目。
（3）模块：通过use来使用，用来控制作用域和路径的私有性。
（4）路径：一个命名例如结构体、函数或模块等项的方式。

2、包和Crate
（1）crate root 是一个源文件，Rust 编译器以它为起始点，并构成你的 crate 的根模块。
（2）包提供一系列功能的一个或多个Crate。
（3）Crate root是src/main.rs或者是src/lib.rs。 说明：如果只有main.rs则说明这个包只有一个crate（main），如果同时拥有main.rs和其它的lib.rs（不一定是这个名字）则说明拥有多个crate。
（4）crate会将一个作用域的相关功能分组到一起，使得该功能可以很方便的在多个项目之间共享。

3、使用模块控制作用域和私有性
（1）创建一个lib可以通过命令cargo new --lib libname来进行创建。
（2）中默认所有项（函数、方法、结构体、枚举、模块和常量）都是私有的，需要使用pub才能暴露给外部。
（3）创建模块，例如：

//factory.rs
mod refrigerator { //冰箱//需要使用 pub，否则别人无法使用
	fn refrigeration() {//需要使用 pub，否则别人无法使用
	}
}

mod washing_machine { //需要使用 pub，否则别人无法使用
	fn wash() {//需要使用 pub，否则别人无法使用
	}
}

//lib.rs
pub mod factory;

//main.rs
use mylib::factory;
fn main() {
	factory::refrigerator::refrigeration();
	println!("Hello, world!");
}

知识点：需要使用pub，否则无法使用。

4、使用绝对路径和使用相对路径
例子：

mod A {
	pub mod B {
		pub fn prin() {
			println!("++++++");
			super::ppp();//使用父路径
		}
	}
	
	pub fn ppp() {
		println!("++++++ ppp");
	}
}
fn main() {
	use A::B::prin; //相对路径
	prin();
	A::B::prin();//绝对路径
	println!("Hello, world!");
}

5、对结构体的使用

mod modA {
	#[derive(Debug)]
	pub struct A {
		pub number: i32,
		name: String,
	}

	impl A {
		pub fn new_a() -> A {
			A {
				number: 20,
				name: String::from("A"),
				}
		}

		pub fn print_a(&self) {
			println!("number = {}, name = {}", self.number, self.name);
		}
	}
}

fn main() {
	let a = modA::A::new_a();
	a.print_a();
	let n = a.name;//error，因为name是私有的
	println!("Hello, world!");
}

6、使用use和as，使用*引进所有

//使用use
use modA::A;
let a = A::new_a();

//使用as
use modA::A as myA;
let a = myA::new_a();

//使用*
use modA::*;
let a = myA::new_a();

7、使用pub use重导出

8、外部包
在Cargo.toml下的dependencies下
（1）路径

[dependencies]
mylib = {path = "./mylib"}

（2）github上的版本

[dependencies]
rust-crypto = "0.2"
serde = "1.0.63"
bincode = "1.2.0"
serde_derive = "1.0.27"

例子：

//! SHA3-256 示例
extern crate crypto;
//extern crate rustc_hex;
use self::crypto::digest::Digest;
use self::crypto::sha3::Sha3;
//use rustc_hex::{ToHex,FromHex};
fn main() {
	// create a SHA3-256 object
	let mut hasher = Sha3::sha3_256();
	
	// write input message
	hasher.input_str("hello world");

	//read hash digest
	let hex = hasher.result_str();
}