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

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

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

作成日: 更新日:

基本的な使い方

__new__ メソッドは、UnboundLocalError クラスの新しいインスタンスを生成するメソッドです。Python における __new__ メソッドは、クラスのインスタンスが作成される際に最初に呼び出される特殊なメソッドであり、オブジェクトの生成そのものを担当します。

UnboundLocalError は、Python のプログラム実行中に、関数やメソッド内でローカル変数が代入される前に参照された場合に発生する例外です。例えば、関数内で変数を初期化する前に使用しようとすると、Python はそれをローカル変数と判断するものの、値が割り当てられていないため、このエラーが発生します。

この UnboundLocalError クラスの __new__ メソッドは、このようなローカル変数の未初期化参照エラーが発生した際に、その状況を表すための新しい例外オブジェクトを生成するために内部的に使用されます。Python インタプリタはエラーを検出すると、自動的にこの __new__ メソッドを呼び出し、エラー情報を持つ UnboundLocalError のインスタンスを作成します。このインスタンスは、その後の処理を経てプログラムへ送出され、エラーとして通知されます。

この __new__ メソッドを直接呼び出す機会は通常ありませんが、UnboundLocalError の発生原因と、それを表すオブジェクトが生成される仕組みを理解することは、Pythonでのデバッグやローカル変数の適切な管理において重要です。

構文(syntax)

1UnboundLocalError.__new__(UnboundLocalError, "エラーメッセージ")

引数(parameters)

cls, *args, **kwargs

  • cls: 新しいインスタンスを生成するクラス
  • *args: 位置引数
  • **kwargs: キーワード引数

戻り値(return)

UnboundLocalError

UnboundLocalErrorクラスの新しいインスタンスを生成して返します。

関連コンテンツ