Podstawy modułów

W miarę rozrastania się programów w Rust trzymanie wszystkiego w jednym pliku staje się uciążliwe. System modułów Rust pozwala organizować kod przez przenoszenie struktur i ich implementacji do osobnych plików.

Aby utworzyć moduł w osobnym pliku, wystarczy utworzyć nowy plik o wybranej nazwie modułu. Na przykład, aby utworzyć moduł player, utwórz plik o nazwie player.rs:

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

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

Aby użyć tego modułu w pliku głównym, deklarujesz go za pomocą słowa kluczowego mod. Dzięki temu Rust szuka pliku o tej nazwie:

// main.rs
mod player;

fn main() {
    // Możemy teraz uzyskać dostęp do elementów modułu player
}

Deklaracja mod player; informuje Rust, aby znalazł i dołączył zawartość pliku player.rs. Możesz myśleć o tym jak o połączeniu kodu z tego pliku z Twoim programem. Nazwa modułu musi dokładnie odpowiadać nazwie pliku (bez rozszerzenia .rs).

Taki podział pozwala trzymać powiązany kod razem. Definicja struktury i wszystkie jej metody znajdują się w jednym dedykowanym pliku, a main.rs pozostaje skupiony na punkcie wejścia programu. W następnej lekcji dowiesz się, jak uzyskać dostęp do elementów umieszczonych w modułach.