Переліки

Ключове слово enum дозволяє створення типу, який може бути одним із кількох різних варіантів. Будь-який варіант, який є дійсним як struct, також є дійсним в enum.

// Створіть `enum` для класифікації вебподії. Зверніть увагу, як імена
// та інформація про тип разом визначають варіант:
// `PageLoad != PageUnload` і `KeyPress(char) != Paste(String)`.
// Кожен із них є різним і незалежним.
enum WebEvent {
    // Варіант `enum` може бути або `unit-like`,
    PageLoad,
    PageUnload,
    // як кортежні структури,
    KeyPress(char),
    Paste(String),
    // або структури у стилі C.
    Click { x: i64, y: i64 },
}

// Функція, яка приймає `WebEvent` enum як аргумент і
// не повертає нічого.
fn inspect(event: WebEvent) {
    match event {
        WebEvent::PageLoad => println!("page loaded"),
        WebEvent::PageUnload => println!("page unloaded"),
        // Деструктуруйте `c` зсередини варіанта `enum`.
        WebEvent::KeyPress(c) => println!("pressed '{}'.", c),
        WebEvent::Paste(s) => println!("pasted \"{}\".", s),
        // Деструктуруйте `Click` на `x` і `y`.
        WebEvent::Click { x, y } => {
            println!("clicked at x={}, y={}.", x, y);
        },
    }
}

fn main() {
    let pressed = WebEvent::KeyPress('x');
    // `to_owned()` створює власний `String` із рядкового зрізу.
    let pasted  = WebEvent::Paste("my text".to_owned());
    let click   = WebEvent::Click { x: 20, y: 80 };
    let load    = WebEvent::PageLoad;
    let unload  = WebEvent::PageUnload;

    inspect(pressed);
    inspect(pasted);
    inspect(click);
    inspect(load);
    inspect(unload);
}

Псевдоніми типів

Якщо ви використовуєте псевдонім типу, ви можете звертатися до кожного варіанта enum через його псевдонім. Це може бути корисно, якщо назва enum занадто довга або занадто загальна, і ви хочете перейменувати його.

enum VeryVerboseEnumOfThingsToDoWithNumbers {
    Add,
    Subtract,
}

// Створює псевдонім типу
type Operations = VeryVerboseEnumOfThingsToDoWithNumbers;

fn main() {
    // Ми можемо звертатися до кожного варіанта через його псевдонім, а не через його довгу і незручну
    // назву.
    let x = Operations::Add;
}

Найпоширеніше місце, де ви це побачите, — це блоки impl, що використовують псевдонім Self.

enum VeryVerboseEnumOfThingsToDoWithNumbers {
    Add,
    Subtract,
}

impl VeryVerboseEnumOfThingsToDoWithNumbers {
    fn run(&self, x: i32, y: i32) -> i32 {
        match self {
            Self::Add => x + y,
            Self::Subtract => x - y,
        }
    }
}

Щоб дізнатися більше про переліки та псевдоніми типів, ви можете прочитати звіт про стабілізацію відтоді, коли ця можливість була стабілізована в Rust.

Див. також:

match, fn, and String, “Type alias enum variants” RFC