在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
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_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中:
还有一种桥的方法是mod.rs.
在上面,新建了一个src_e文件夹,下面有e.rs,内容如下:
pub fn e_echo(){
println!("e_echo!");
}
此时,如果在内部再建立一个mod.rs的话,那么,mod.rs也是一种桥。可以让外部更方面地访问到e.rs.
但是,这种情况和外部建立一个与文件夹同名的rs文件有所不同。
e_echo()函数的前面路径是e,不再是src_e了。