動的なエラー型

すべての異なる可能性を網羅する独自の enum を書かなくても、任意の型のエラーを返せるようにしたい場合があります。std::error::Error トレイトを使うと、任意のエラーを保持できるトレイトオブジェクトを簡単に作成できます。

// Copyright 2023 Google LLC
// SPDX-License-Identifier: Apache-2.0

use std::error::Error;
use std::fs;
use std::io::Read;

fn read_count(path: &str) -> Result<i32, Box<dyn Error>> {
    let mut count_str = String::new();
    fs::File::open(path)?.read_to_string(&mut count_str)?;
    let count: i32 = count_str.parse()?;
    Ok(count)
}

fn main() {
    fs::write("count.dat", "1i3").unwrap();
    match read_count("count.dat") {
        Ok(count) => println!("Count: {count}"),
        Err(err) => println!("Error: {err}"),
    }
}

read_count 関数は、std::io::Error（ファイル操作から）または std::num::ParseIntError（String::parse から）を返す可能性があります。

エラーを Box 化するとコード量を減らせますが、その代わりに、プログラム内で異なるエラーケースをそれぞれ明確に処理する能力は失われます。そのため、ライブラリの公開 API で Box<dyn Error> を使うのは一般的には良い考えではありませんが、単にどこかでエラーメッセージを表示したいだけのプログラムでは、良い選択肢になりえます。

カスタムエラー型を定義する際は、それを Box 化できるように std::error::Error トレイトを必ず実装してください。

Comprehensive Rust 🦀

動的なエラー型