enum / バリアント定義

// データなしのバリアントです。
enum Direction {
    North,
    South,
    East,
    West,
}

// タプルバリアント（データを持ちます）。
enum Shape {
    Circle(f64),          // 半径
    Rectangle(f64, f64),  // 幅, 高さ
}

// 構造体バリアント（フィールドに名前があります）。
enum Message {
    Quit,
    Move { x: i32, y: i32 },
    Write(String),
    ChangeColor(u8, u8, u8),
}

// 使用例です。
let dir = Direction::North;
let s = Shape::Circle(3.0);
let msg = Message::Move { x: 10, y: 20 };

#[derive(Debug)]
enum Coin {
    Penny,
    Nickel,
    Dime,
    Quarter,
}

#[derive(Debug)]
enum IpAddr {
    V4(u8, u8, u8, u8),
    V6(String),
}

#[derive(Debug)]
enum Event {
    KeyPress(char),
    MouseMove { x: i32, y: i32 },
    Click { button: u8, x: i32, y: i32 },
    Resize(u32, u32),
    Quit,
}

impl Coin {
    // バリアントに対応する値を返すメソッドです。
    fn value_in_cents(&self) -> u32 {
        match self {
            Coin::Penny => 1,
            Coin::Nickel => 5,
            Coin::Dime => 10,
            Coin::Quarter => 25,
        }
    }
}

fn process_event(event: &Event) {
    match event {
        Event::KeyPress(c) => println!("キー入力: {}", c),
        Event::MouseMove { x, y } => println!("マウス移動: ({}, {})", x, y),
        Event::Click { button, x, y } => {
            println!("クリック: ボタン{} at ({}, {})", button, x, y)
        }
        Event::Resize(w, h) => println!("リサイズ: {}x{}", w, h),
        Event::Quit => println!("終了"),
    }
}

fn main() {
    // ユニットバリアントです。
    let coin = Coin::Quarter;
    println!("{:?} = {} セント", coin, coin.value_in_cents());

    // タプルバリアントです。
    let home = IpAddr::V4(192, 168, 1, 1);
    let loopback = IpAddr::V6(String::from("::1"));
    println!("{:?}", home);
    println!("{:?}", loopback);

    // 各種バリアントを使います。
    let events = vec![
        Event::KeyPress('a'),
        Event::MouseMove { x: 100, y: 200 },
        Event::Click { button: 1, x: 50, y: 75 },
        Event::Resize(1920, 1080),
        Event::Quit,
    ];

    for event in &events {
        process_event(event);
    }
}

Rustのenumは他の言語の列挙型より強力で、各バリアントが異なる型・数のデータを持てます。これはC言語の判別共用体（tagged union）に相当します。

enumのバリアントは型名と同じ名前空間に属するため、『use Direction::*;』とすることで『North』のように短く書けます。

enumへのメソッド追加とmatchによる処理は『impl enum / match でのパターン分岐』を参照してください。