サンプルコードで身につける: pub — 公開範囲を制御する

mod cafe {
    pub fn order() {
        prepare(); // 非公開の関数もモジュール内からは呼べる
        println!("コーヒーをどうぞ");
    }

    fn prepare() {
        println!("豆を挽いています...");
    }
}

fn main() {
    cafe::order();
    // cafe::prepare(); // エラー: 非公開の関数は外から呼べない
}

mod shapes {
    pub struct Point {
        pub x: i32, // フィールドにも個別に pub が必要
        pub y: i32,
    }
}

fn main() {
    let p = shapes::Point { x: 3, y: 4 };
    println!("({}, {})", p.x, p.y);
}

mod price {
    pub fn total(unit: u32, quantity: u32) -> u32 {
        with_tax(unit * quantity)
    }

    fn with_tax(amount: u32) -> u32 {
        amount * 110 / 100 // 税率の計算方法は外から見えない
    }
}

fn main() {
    println!("合計 = {} 円", price::total(500, 2));
    // with_tax の実装はモジュールの中だけで自由に変更できる
}

mod bank {
    pub struct Account {
        pub owner: String,
        balance: u32, // 非公開: 外から直接読み書きできない
    }

    impl Account {
        pub fn new(owner: &str) -> Account {
            Account { owner: String::from(owner), balance: 1000 }
        }
        pub fn balance(&self) -> u32 { // メソッドにも pub が必要
            self.balance
        }
    }
}

fn main() {
    let account = bank::Account::new("alice");
    println!("{} の残高 = {} 円", account.owner, account.balance());
}

mod user_repo {
    pub struct User {
        pub id: u32,
        pub name: String,
    }
    pub fn find(id: u32) -> User {
        User { id, name: lookup_name(id) } // 公開する入り口は find だけ
    }
    fn lookup_name(id: u32) -> String {
        match id {
            1 => String::from("alice"),
            _ => String::from("unknown"),
        }
    }
}

fn main() {
    let user = user_repo::find(1);
    println!("id = {}, name = {}", user.id, user.name);
}