モジュールの基礎

Rust プログラムが大きくなると、すべてを 1 つのファイルにまとめておくのは扱いにくくなります。Rust のモジュールシステムを使うと、struct とその実装を別々のファイルに移動して、コードを整理できます。

別のファイルにモジュールを作成するには、目的のモジュール名を付けた新しいファイルを作成するだけです。たとえば、player モジュールを作成するには、player.rs という名前のファイルを作成します。

// player.rs
struct Player {
    name: String,
    score: u32,
}

impl Player {
    fn new(name: String) -> Player {
        Player { name, score: 0 }
    }
}

このモジュールを main ファイルで使用するには、mod キーワードを使って宣言します。これにより、Rust はその名前のファイルを探します。

// main.rs
mod player;

fn main() {
    // これで player モジュールのアイテムにアクセスできます
}

mod player; 宣言は、Rust に player.rs を見つけてその内容を含めるよう指示します。これは、そのファイルのコードをプログラムにリンクするようなものです。モジュール名は、.rs 拡張子を除いて、ファイル名と完全に一致していなければなりません。

この分離により、関連するコードをまとめておけます。struct の定義とそのすべてのメソッドは専用のファイルに配置し、main.rs はプログラムのエントリーポイントに集中したままにします。次のレッスンでは、モジュールに配置した items に実際にアクセスする方法を学びます。