可见性

项（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. }