unwrap.

unwrapは、Option型やResult型に包まれた値を取り出す標準ライブラリのメソッドです¹²。Some(値)・Ok(値)ならその中身を返し、None・Errならパニックして処理を中断します。パニックの代わりに既定値を返すunwrap_orなど、unwrap以外にもunwrap系のメソッドが複数存在します。

fn find_price(item: &str) -> Option<i32> {
    match item {
        "りんご" => Some(120),
        _ => None,
    }
}

fn main() {
    let apple = find_price("りんご").unwrap(); // Someと分かっているので取り出す
    println!("りんご: {apple}円");

    let banana = find_price("バナナ").unwrap_or(0); // Noneなら0を使う
    println!("バナナ: {banana}円");
}

主なunwrap系メソッド

OptionとResultの両方に、同じ名前のメソッドが用意されています。

unwrap_orの引数はSome・Okのときでも必ず評価されるため、既定値の生成にコストがかかる場合は、必要なときだけ評価されるunwrap_or_elseを使います²。

unwrapを使ってよい場面

The Rust Programming Languageは、unwrapとexpectが適切な場面として次の2つを挙げています³。

• サンプルコード・プロトタイプ・テスト: エラー処理の方針をまだ決めていない段階では、後から手を入れる目印として使えます。テストでは失敗したテスト自体をパニックで落とすことが望ましい挙動です
• コンパイラより開発者のほうが多くを知っている場合: Errにならないことがコードを読めば分かるものの、その根拠をコンパイラが理解できない場合です

逆に、外部入力やファイル操作のように失敗が現実に起こりうる箇所では、取り出す前にmatch式・if let式・let-else文で分岐するか、?演算子で呼び出し元に処理を委ねます。unwrap系は「取り出せなかったときにどうするか」をその場で決め打ちするメソッドなので、決め打ってよい根拠があるかどうかが選択の基準になります。

fn main() {
    // 直書きの値なので必ず数値として解釈できる
    let people: u32 = "4".parse().expect("人数の指定は数値として正しいはず");
    println!("1人あたり{}円", 3000 / people);
}

補足