• 可见性

    可见性

    项（item）默认情况下拥有私有的可见性（private visibility），不过可以加上 pub （public 的前 3 个字母）修饰语（modifier）来改变默认行为。一个模块之外的作用域只能访问该模块里面的公有项（public item）。

    1. // 一个名为 `my` 的模块
    2. mod my {
    3.     // 在模块中的项默认带有私有可见性。
    4.     fn private_function() {
    5.         println!("called `my::private_function()`");
    6.     }
    8.     // 使用 `pub` 修饰语来改变默认可见性。
    9.     pub fn function() {
    10.         println!("called `my::function()`");
    11.     }
    13.     // 在同一模块中，项可以访问其它项，即使是私有属性。
    14.     pub fn indirect_access() {
    15.         print!("called `my::indirect_access()`, that\n> ");
    16.         private_function();
    17.     }
    19.     // 项也可以嵌套。
    20.     pub mod nested {
    21.         pub fn function() {
    22.             println!("called `my::nested::function()`");
    23.         }
    25.         #[allow(dead_code)]
    26.         fn private_function() {
    27.             println!("called `my::nested::private_function()`");
    28.         }
    29.     }
    31.     // 嵌套项的可见性遵循相同的规则。
    32.     mod private_nested {
    33.         #[allow(dead_code)]
    34.         pub fn function() {
    35.             println!("called `my::private_nested::function()`");
    36.         }
    37.     }
    38. }
    40. fn function() {
    41.     println!("called `function()`");
    42. }
    44. fn main() {
    45.     // 模块允许在拥有相同名字的项之间消除歧义。
    46.     function();
    47.     my::function();
    49.     // 公有项，包括内部嵌套的公有项，可以在父级的模块中访问到。
    50.     my::indirect_access();
    51.     my::nested::function();
    53.     // 一个模块中的私有项不能被直接访问，即使私有项嵌套在公有的模块中：
    55.     // 报错！`private_function` 是私有的。
    56.     //my::private_function();
    57.     // 试一试 ^ 将此行注释去掉
    59.     // 报错！ `private_function` 是私有的。
    60.     //my::nested::private_function();
    61.     // 试一试 ^ 将此行注释去掉    
    63.     // 报错！ `private_nested` 是私有的模块。
    64.     //my::private_nested::function();
    65.     // 试一试 ^ 将此行注释去掉    
    67. }