Rust语言学习小记（模块）

5. 模块

5.1 模块定义
在一个project中，模块的入口为src/lib.rs。模块的声明以mod关键字开头。项目的根模块必须在lib.rs中进行声明。
模块声明遵循如下递归规则：

• 如果一个叫做 foo 的模块没有子模块，应该将 foo 的声明放入叫做 foo.rs 的文件中。
• 如果一个叫做 foo 的模块有子模块，应该将 foo 的声明放入叫做 foo/mod.rs 的文件中。

5.2 模块实现
模块的实现与声明可以在一起，即mod关键字后跟一个代码块，内置函数定义：

//src/lib.rs    or    src/some_mod.rs   or   src/some_mod/mod.rs
mod mod1{
    fn func(){
      //do something
    }
}

模块的实现也可以与模块的声明分离，使用mod关键字在 src/lib.rs 文件 或者子模块的 mod.rs 文件中声明模块，然后将实现放入模块的实现文件中。如果没有子模块，则模块实现的文件名与模块名一致：

    // 声明
   // src/lib.rs   or  src/some_mod/mod.rs
   mod mod2;
    
    // 实现
   //src/mod2.rs   or   src/some_mod/mod2.rs
   fn func(){
      //do something
   } 

5.3 即便在项目的子模块中使用外部 crate，extern crate 也应该位于根模块（也就是 src/main.rs 或 src/lib.rs）。接着，在子模块中，我们就可以像顶层模块那样引用外部 crate 中的项了。

5.4 可见性。一个模块如果是公有的，且模块中函数是公有的，则该函数可以被外部调用。可见性规则：

如果一个项是公有的，它能被任何父模块访问
如果一个项是私有的，它能被其直接父模块及其任何子模块访问

所谓直接父模块，指的是该项的定义所在的模块。

5.4 使用use语句可以将某个命名空间里的名称引入当前作用域：

   mod a {
        pub mod b {
            pub mod c{
                pub fn d () {}
            }
        }
    }
  
  // use 将名字引入作用域
  fn test_concrete(){
      use a::b::c;
      c::d();
  }
  
  //使用*表示引入命名空间下所有名字
  fn test_glob() {
    use a::b::c::*;
    d();
  }
  
  enum TestEnum{
      A,
      B,
  }
  
  //枚举也是命名空间，可以用use引入指定的名字
  //可以在 :: 符号后面跟上 {} 来从同一个命名空间引入多个名字
  fn test_enum{
      use TestEnum::{A,B};
  }

5.5 默认情况下，模块搜索的起始路径为当前模块。使用::开头搜索模块，代表从根路径开始搜寻模块。使用super来寻找模块，则代表从当前模块的上一层开始搜寻。