结构体的可见性

结构体对字段的可见性有额外的规定（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 方法