21. pub — 公開範囲を制御する

モジュールの中の関数や構造体は、デフォルトではすべて非公開で、モジュールの外から呼び出せません。外に見せたいものにだけ pub を付ける、というのが Rust の可視性のルールです。

実務では「外から使ってよい入り口の関数だけ pub にして、内部のヘルパーは非公開のまま隠す」という形で API の境界を作ります。非公開の関数はモジュールの外に影響を与えず自由に書き換えられるため、あとからの変更に強くなります。

struct を pub にしてもフィールドは非公開のままで、見せたいフィールドには個別に pub が必要です。「pub は付けた対象だけを公開する」と覚えておくとつまずきません。

▶ サンプルコードを実行してみよう(自由に書き換えてOK)

Rust

mod auth {
    pub fn login(name: &str) {
        let token = make_token(name);
        println!("{} でログイン (token = {})", name, token);
    }

    fn make_token(name: &str) -> usize {
        name.len() * 7 // pub なしの内部ヘルパー
    }
}

fn main() {
    auth::login("alice");
    // auth::make_token("alice"); // エラー: 非公開の関数は外から呼べない
}

サンプルコードで身につける(5本) →

学んだ概念を、素朴な例から実務寄りの例まで5つの具体例で確認します。

公式ドキュメントで詳しく ↗