24. Result<T, E> — 回復可能なエラー

失敗しうる処理の結果は、標準の enum である Result<T, E> で表します。成功なら Ok(値)、失敗なら Err(エラー) を返し、呼び出し側は match で両方のケースを処理します。

ファイル読み込みや文字列のパースなど、標準ライブラリの失敗しうる関数はほぼすべて Result を返します。例外機構と違い、エラーの可能性が関数のシグネチャに現れるため、処理し忘れたままエラーが素通りすることがありません。

Err を無視するとコンパイラが警告を出してくれます。「エラーは戻り値として受け取り、match でさばく」が Rust のエラー処理の基本形です。

▶ サンプルコードを実行してみよう(自由に書き換えてOK)

Rust

fn parse_age(input: &str) -> Result<u32, String> {
    match input.parse::<u32>() {
        Ok(n) => Ok(n),
        Err(_) => Err(format!("'{}' は数値ではありません", input)),
    }
}

fn main() {
    match parse_age("30") {
        Ok(age) => println!("年齢: {}", age),
        Err(e) => println!("エラー: {}", e),
    }
    match parse_age("abc") {
        Ok(age) => println!("年齢: {}", age),
        Err(e) => println!("エラー: {}", e),
    }
}

公式ドキュメントで詳しく ↗