• 结构体的可见性
    • 参见：

    结构体的可见性

    结构体对字段的可见性有额外的规定（Structs have an extra level of visibility with their fields）。其可见性默认为私有，也可以加上 pub 修饰语来改变默认属性。只有当从定义在外部的模块访问一个结构体时，这可见性才显得重要，并具有隐藏信息的目的（封装，encapsulatoin）（原文：This visibility only matters when a struct is accessed from outside the module where it is defined, and has the goal of hiding information (encapsulation)）。

    1. mod my {
    2.     // 一个公有的结构体，带有一个公有的泛型类型 `T` 的字段
    3.     pub struct WhiteBox<T> {
    4.         pub contents: T,
    5.     }
    7.     // 一个公开的结构体，带有一个私有的泛型类型 `T` 的字段    
    8.     #[allow(dead_code)]
    9.     pub struct BlackBox<T> {
    10.         contents: T,
    11.     }
    13.     impl<T> BlackBox<T> {
    14.         // 一个公有的构造器方法
    15.         pub fn new(contents: T) -> BlackBox<T> {
    16.             BlackBox {
    17.                 contents: contents,
    18.             }
    19.         }
    20.     }
    21. }
    23. fn main() {
    24.     // 带有公有字段的公有的结构体，可以像平常一样构造
    25.     let white_box = my::WhiteBox { contents: "public information" };
    27.     // 并且它们的字段可以正常访问到。
    28.     println!("The white box contains: {}", white_box.contents);
    30.     // 带有私有字段的公有结构体不能使用字段名来构造。
    31.     // 报错！`BlackBox` 含有私有字段。
    32.     //let black_box = my::BlackBox { contents: "classified information" };
    33.     // 试一试 ^ 将此行注释去掉
    36.     // 不过带有私有字段的结构体可以使用公有的构造器来创建。
    37.     let _black_box = my::BlackBox::new("classified information");
    39.     // 并且一个结构体中的私有字段不能访问到。
    40.     // 报错！`content` 字段是私有的。
    41.     //println!("The black box contains: {}", _black_box.contents);
    42.     // 试一试 ^ 将此行注释去掉    
    44. }

    参见：

    泛型 and 方法