Webエンジニア向けプログラミング解説動画をYouTubeで配信中!
▶ チャンネル登録はこちら

【Python3.x】BaseExceptionGroup::exceptions定数の使い方

exceptions定数の使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

exceptions定数は、BaseExceptionGroupクラスのインスタンスが、複数の例外をまとめて扱う際に、それらの個々の例外オブジェクトを保持するタプルを表す定数です。BaseExceptionGroupは、Python 3.11で導入された、関連する複数の例外をグループ化して一度に処理するための特別な例外クラスです。この定数にアクセスすることで、BaseExceptionGroupオブジェクトに含まれるすべての例外をタプル形式で取得できます。

これにより、例えば、複数の非同期タスクが並行して実行され、それぞれが異なるエラーを発生させた場合でも、これらのエラーを一つのBaseExceptionGroupとして捕捉し、このexceptions定数を通じて個々のエラーの詳細を順序立てて確認したり、特定のタイプのエラーのみを抽出して処理したりすることが容易になります。この定数は、プログラムの堅牢性を高め、複雑なエラーハンドリングを簡潔に記述するための重要な要素です。タプルとして保持されるため、各例外は発生時の情報とともに順序良くアクセス可能です。

構文(syntax)

1exception_group_instance = ExceptionGroup("Message", [ValueError("Error A"), TypeError("Error B")])
2contained_exceptions = exception_group_instance.exceptions

引数(parameters)

引数なし

引数はありません

戻り値(return)

tuple[BaseException, ...]

この定数は、発生した例外のグループをタプル形式で返します。タプルには、グループ化された個々の例外オブジェクトが含まれます。

関連コンテンツ