if let — 1パターンだけの照合のサンプルコード — Rust

1最小の if let

「Text バリアントのときだけ中身を表示する」を if let で書いた最小例です。パターンに一致すればブロックが実行され、一致しなければ何も起きずに次へ進みます。match と違って他のバリアントの分岐を書かなくてよいのがポイントです。

Rust

enum Message {
    Text(String),
    Ping,
}

fn main() {
    let msg = Message::Text(String::from("こんにちは"));
    if let Message::Text(content) = &msg {
        println!("本文: {}", content);
    }
    let ping = Message::Ping;
    if let Message::Text(content) = &ping {
        println!("本文: {}", content); // Ping なので実行されない
    }
    println!("一致しなければ何も起きずに進む");
}

2else で「一致しなかったとき」を書く

if let に else を付けると「そのバリアントだったとき/それ以外」の2分岐になります。バリアントが2種類しかない enum なら、match とほぼ同じ表現力をより短く書けます。オンライン/オフラインのような二値+データの状態表示にちょうどよい形です。

Rust

enum Connection {
    Online(u32),
    Offline,
}

fn main() {
    let conn = Connection::Online(42);
    if let Connection::Online(users) = &conn {
        println!("接続中: {}人が利用中", users);
    } else {
        println!("オフラインです");
    }
    let conn2 = Connection::Offline;
    if let Connection::Online(users) = &conn2 {
        println!("接続中: {}人が利用中", users);
    } else {
        println!("オフラインです");
    }
}

3取り出した値で計算する

if let で束縛した変数はブロック内で普通の値として使えるので、そのまま計算に回せます。この例では割引率を取り出して価格計算に使い、無効なクーポンは else で弾いています。「使える場合だけ値を取り出して処理する」は割引・設定値・キャッシュなど実務のあちこちで出てくる形です。

Rust

enum Coupon {
    Percent(u32),
    Invalid,
}

fn main() {
    let price = 2000;
    let coupon = Coupon::Percent(20);
    if let Coupon::Percent(rate) = &coupon {
        let discounted = price * (100 - rate) / 100;
        println!("{}円 → {}円 ({}%引き)", price, discounted, rate);
    }
    let expired = Coupon::Invalid;
    if let Coupon::Percent(rate) = &expired {
        println!("{}%引きが使えます", rate);
    } else {
        println!("クーポンは無効です");
    }
}

4ループの中で特定バリアントだけ拾う

ログの配列を for で回し、Error バリアントだけを if let で拾い出す例です。「他のバリアントは無視してよい」というif let の性質が、フィルタリングと素直に噛み合います。大量のイベント列から関心のある種類だけ処理するのは、監視やログ集計の実務で頻出のパターンです。

Rust

enum LogEntry {
    Error(String),
    Heartbeat,
}

fn main() {
    let logs = [
        LogEntry::Heartbeat,
        LogEntry::Error(String::from("接続に失敗")),
        LogEntry::Error(String::from("タイムアウト")),
    ];
    let mut error_count = 0;
    for log in &logs {
        if let LogEntry::Error(message) = log {
            println!("エラー検出: {}", message);
            error_count += 1;
        }
    }
    println!("エラー件数: {}", error_count);
}

5設定値の上書きを if let で表す

「個別に指定があればその値、なければ既定値」という設定読み込みの定番処理を if let + else で表した実務寄りの例です。構造体のフィールドに入った enum へも &config.timeout のようにそのままパターンを当てられます。後のレッスンで学ぶ Option<T> も、まさにこの形で if let とよく組み合わされます。

Rust

enum Timeout {
    Seconds(u32),
    Default,
}
struct Config {
    name: String,
    timeout: Timeout,
}

fn main() {
    let api = Config { name: String::from("api"), timeout: Timeout::Seconds(30) };
    let web = Config { name: String::from("web"), timeout: Timeout::Default };
    for config in [&api, &web] {
        if let Timeout::Seconds(sec) = &config.timeout {
            println!("{}: タイムアウト {}秒", config.name, sec);
        } else {
            println!("{}: 既定値を使用", config.name);
        }
    }
}

サンプルコードで身につける: if let — 1パターンだけの照合

1最小の if let

2else で「一致しなかったとき」を書く

3取り出した値で計算する

4ループの中で特定バリアントだけ拾う

5設定値の上書きを if let で表す