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

【Python3.x】BaseExceptionGroup::__new__()メソッドの使い方

__new__メソッドの使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

__new__メソッドは、クラスの新しいインスタンスを生成する処理を実行するメソッドです。Python 3.11で導入されたBaseExceptionGroupは、複数の例外をまとめて一つの例外として扱うための基底クラスです。このBaseExceptionGroupクラスの__new__メソッドは、特定のメッセージと、そのグループに属する個々の例外のリストを受け取り、これらを包含する新しいBaseExceptionGroupのインスタンスを生成する役割を担います。

具体的には、例外グループ全体の概要を表す文字列メッセージと、グループ化するBaseExceptionのサブクラスインスタンスのリストを引数として受け取り、その情報を持つBaseExceptionGroupオブジェクトを構築して返します。この機能により、例えば並行処理や非同期処理において複数のタスクが同時にエラーを発生させた場合でも、それらのエラーを一元的に捕捉し、一つの例外として処理することが可能になります。これにより、複雑なエラーハンドリングロジックを簡素化し、プログラムの安定性と保守性を向上させることができます。

構文(syntax)

1an_exception_group = ExceptionGroup(message_string, list_of_exceptions_objects)

引数(parameters)

cls, message: str, exceptions: list[BaseException]

  • cls: BaseExceptionGroupクラスのインスタンスを生成するために使用されるクラスオブジェクト
  • message: str: 例外グループに関する説明メッセージ
  • exceptions: list[BaseException]: この例外グループに含まれる個々の例外のリスト

戻り値(return)

BaseExceptionGroup

new メソッドは、新しく生成された BaseExceptionGroup オブジェクトを返します。このオブジェクトは、例外グループのインスタンスとして機能します。

関連コンテンツ