Rust:mod、crate、super、self、pub use等模块系统用法梳理

在Rust模块系统中,有诸多的概念和用法,不容易搞清楚,理一下,很有必要。
cargo是从包的根目录开始找相应的文件的。

一、packages、crates、modules

packages: 通过cargo new 创建;
crates: 通过cargo new --lib 创建。有根包和子包。即一个根包下可以包含多个子包。
modules: 通过关键字mod加模块定义

二、各种用法

src下有同个级:兄弟、父、子三个层级。

1、mod

往往是引入与当前文件同级的文件夹下(兄弟模块下)的文件。

2、crate

代表引用当前文件同级的文件。为同级文件时,意义和self相同。但如果是同级文件夹,不能混用。

3、super

super:代表当前文件的上一级目录(父模块) 。super后面可以直接接函数。也可以接“*”,表示所有函数。

4、self

见crate

5、pub use

三、桥

在src下,往往有一个子目录,比如名字叫core. 里面还有两个文件,read.rs,write.rs.此时,需要有一个文件把这两个文件串起来。
此时,可以在core目录同级,建一个core.rs文件,把core目录下的两个文件串起来,对外可见。
我称这种与目录相同的rs文件为桥(个人定义,不规范)文件。

比如:

pub mod a;
pub mod c;
pub use a::*; //不能省
pub use c::*;//不能省

四、实例1

1、具体的例子
相应的结构:
Rust:mod、crate、super、self、pub use等模块系统用法梳理_第1张图片
(1)a.rs

pub fn a_echo(){
    println!("a_echo!");
}

(2)c.rs

注意,crate不能用self替换crate。

use crate::src_a::a::*;
pub fn c_echo(){
    println!("c_echo!");
    a_echo();
}

(3)b.rs

use crate::src_a::a_echo;
//如何引入a.rs或c.rs中的函数
pub fn b_echo(){
    println!("b_echo! => call a()!");
    a_echo();

}

(4)src_a.rs

pub mod a;
pub mod c;
pub use a::*;
pub use c::*;

(5)src_b.rs

pub mod b;
pub use b::*;

(6)main.rs
crate和self可以互相替代。

pub mod src_a;
pub mod src_b;
pub use self::src_a::*;
pub use crate::src_b::*;

fn main() {
    println!("Hello, world!");
    src_a::a_echo();
    src_b::b_echo();
}

2、解决的问题:

(1) c.rs =>调用a.rs 中函数
(2) b.rs =>调用a.rs 中函数
(3)main.rs =>调用a.rs; 调用c.rs中函数;必须要使用“桥”。

3、src_a.rs和src_b.rs相当于分别是a.rs和c.rs与b.rs的代理。

Rust:mod、crate、super、self、pub use等模块系统用法梳理_第2张图片
五、实例2,更进一步

如果在rust_test中,src外,还有一个lib, b。
b是通过在rust_test中cargo new --lib d而来。
b是一个单独的库文件,

base) PS D:\rust_test\d> cd src
(base) PS D:\rust_test\d\src> tree /f
卷 新加卷 的文件夹 PATH 列表  
卷序列号为 6E25-CA92
D:.
    lib.rs

没有子文件夹

(base) PS D:\rust_test\d\src> 

lib.rs的文件:

pub fn d_echo(){
    println!("d_echo!");
}

那么,在rust_test中的main.rs如何调用d中lib函数,d_echo()?

1、首先要在rust_test的toml文件中进行修改,增加对d的依赖。

[dependencies]

d = { path = "../rust_test/d" }

2、在main.rs中:

直接使用路径表达即可。
Rust:mod、crate、super、self、pub use等模块系统用法梳理_第3张图片
六、有趣的mod.rs

还有一种桥的方法是mod.rs.
Rust:mod、crate、super、self、pub use等模块系统用法梳理_第4张图片
在上面,新建了一个src_e文件夹,下面有e.rs,内容如下:

pub fn e_echo(){
    println!("e_echo!");
}

此时,如果在内部再建立一个mod.rs的话,那么,mod.rs也是一种桥。可以让外部更方面地访问到e.rs.

但是,这种情况和外部建立一个与文件夹同名的rs文件有所不同。

e_echo()函数的前面路径是e,不再是src_e了。

你可能感兴趣的:(Rust)