可见性

默认情况下，模块中的项拥有私有的可见性（private visibility），不过可以加上 pub 修饰语来重载这一行为。模块中只有公有的（public）项可以从模块外的作用域 访问。

``rust,editable // 一个名为my_mod的模块 mod my_mod { // 模块中的项默认具有私有的可见性 fn private_function() { println!("calledmy_mod::private_function()`”); }

  1. // 使用 `pub` 修饰语来改变默认可见性。
  2. pub fn function() {
  3.     println!("called `my_mod::function()`");
  4. }
  6. // 在同一模块中，项可以访问其它项，即使它是私有的。
  7. pub fn indirect_access() {
  8.     print!("called `my_mod::indirect_access()`, that\n> ");
  9.     private_function();
  10. }
  12. // 模块也可以嵌套
  13. pub mod nested {
  14.     pub fn function() {
  15.         println!("called `my_mod::nested::function()`");
  16.     }
  18.     #[allow(dead_code)]
  19.     fn private_function() {
  20.         println!("called `my_mod::nested::private_function()`");
  21.     }
  23.     // 使用 `pub(in path)` 语法定义的函数只在给定的路径中可见。
  24.     // `path` 必须是父模块（parent module）或祖先模块（ancestor module）
  25.     pub(in crate::my_mod) fn public_function_in_my_mod() {
  26.         print!("called `my_mod::nested::public_function_in_my_mod()`, that\n > ");
  27.         public_function_in_nested()
  28.     }
  30.     // 使用 `pub(self)` 语法定义的函数则只在当前模块中可见。
  31.     pub(self) fn public_function_in_nested() {
  32.         println!("called `my_mod::nested::public_function_in_nested");
  33.     }
  35.     // 使用 `pub(super)` 语法定义的函数只在父模块中可见。
  36.     pub(super) fn public_function_in_super_mod() {
  37.         println!("called my_mod::nested::public_function_in_super_mod");
  38.     }
  39. }
  41. pub fn call_public_function_in_my_mod() {
  42.     print!("called `my_mod::call_public_funcion_in_my_mod()`, that\n> ");
  43.     nested::public_function_in_my_mod();
  44.     print!("> ");
  45.     nested::public_function_in_super_mod();
  46. }
  48. // `pub(crate)` 使得函数只在当前 crate 中可见
  49. pub(crate) fn public_function_in_crate() {
  50.     println!("called `my_mod::public_function_in_crate()");
  51. }
  53. // 嵌套模块的可见性遵循相同的规则
  54. mod private_nested {
  55.     #[allow(dead_code)]
  56.     pub fn function() {
  57.         println!("called `my_mod::private_nested::function()`");
  58.     }
  59. }

}

fn function() { println!(“called function()“); }

fn main() { // 模块机制消除了相同名字的项之间的歧义。 function(); my_mod::function();

  1. // 公有项，包括嵌套模块内的，都可以在父模块外部访问。
  2. my_mod::indirect_access();
  3. my_mod::nested::function();
  4. my_mod::call_public_function_in_my_mod();
  6. // pub(crate) 项可以在同一个 crate 中的任何地方访问
  7. my_mod::public_function_in_crate();
  9. // pub(in path) 项只能在指定的模块中访问
  10. // 报错！函数 `public_function_in_my_mod` 是私有的
  11. //my_mod::nested::public_function_in_my_mod();
  12. // 试一试 ^ 取消该行的注释
  14. // 模块的私有项不能直接访问，即便它是嵌套在公有模块内部的
  16. // 报错！`private_function` 是私有的
  17. //my_mod::private_function();
  18. // 试一试 ^ 取消此行注释
  20. // 报错！`private_function` 是私有的
  21. //my_mod::nested::private_function();
  22. // 试一试 ^ 取消此行的注释
  24. // Error! `private_nested` is a private module
  25. //my_mod::private_nested::function();
  26. // 试一试 ^ 取消此行的注释

}