構造体、列挙型、トレイト

Rust Error Handling: Result and ?

Errors are values in Rust. Return Result, handle it with match, and pass errors on with ?.

中級
約3分で読めます
実行できるサンプル 1 件

学べること

Ok and Err
The ? operator
Your own error messages

コードを実行 →

parse_and_double("abc")

1text.parse()fails
2?returns early
3Err(...)the caller gets the error

Success or error, as a value

Rust has no exceptions. A function that can fail returns Result<T, E>, which is either Ok(value) or Err(error). The caller decides what to do with the error.

The ? after parse returns the error to the caller at once when parsing fails; otherwise it gives the number. divide uses a String as its error type and returns Err for a zero divisor. match prints the value or the error message.

重要なポイント

Result<T, E> is Ok(value) or Err(error).
? returns the error to the caller at once.
The caller decides what to do.

実行できる Rust のサンプル

Rust

コードを実行 →

main.rs

use std::num::ParseIntError;

fn parse_and_double(text: &str) -> Result<i32, ParseIntError> {
    let number: i32 = text.trim().parse()?; // ? returns the error early
    Ok(number * 2)
}

fn divide(a: i32, b: i32) -> Result<i32, String> {
    if b == 0 {
        return Err(String::from("cannot divide by zero"));
    }
    Ok(a / b)
}

fn main() {
    for input in ["21", "abc"] {
        match parse_and_double(input) {
            Ok(value) => println!("{input} -> {value}"),
            Err(error) => println!("{input} -> error: {error}"),
        }
    }

    println!("{:?}", divide(10, 2));
    println!("{:?}", divide(1, 0));
}

この例の実行ボタンを作成実行結果

21 -> 42
abc -> error: invalid digit found in string
Ok(5)
Err("cannot divide by zero")

練習

サンプルをオンラインコンパイラーで開き、値を変えたり行を追加したりして、実行する前に出力を予想してみましょう。次に、わざとコードを壊してコンパイラーのメッセージを読んでみてください。

このレッスンを終えましたか?

学習済みにすると進み具合を記録できます。

次へ: Bank Account with Result →

チャレンジで練習する

このレッスンの内容を使って実際の問題を解きましょう。各チャレンジはブラウザで動き、すぐにテストされ、AI のレビューも受けられます。

すべてのチャレンジ