Rust 程式設計視訊教程對應講解內容－包、crate、模組

頭條地址：https://www.ixigua.com/i676544267458235648...
Ｂ站地址：https://www.bilibili.com/video/av78062009?...
網易雲課堂地址：https://study.163.com/course/introduction....

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();
}

本作品採用《CC 協議》，轉載必須註明作者和本文連結

令狐一衝

Rust 程式設計視訊教程對應講解內容－包、crate、模組

相關文章