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

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

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

作成日: 更新日:

基本的な使い方

__new__メソッドは、Pythonの組み込み例外クラスであるValueErrorのインスタンスが生成される際に、最初に実行される特殊なメソッドです。Pythonにおけるオブジェクトの生成プロセスは2段階で行われます。まず、__new__メソッドが呼び出され、新しいオブジェクトのインスタンスそのものをメモリ上に作成し、そのインスタンスを返却します。その後、__new__が返したインスタンスに対して__init__メソッドが呼び出され、インスタンスの初期化(属性の設定など)が行われます。

ValueErrorクラスの__new__メソッドは、プログラムの実行中に不正な値が関数やメソッドに渡されたことを示すValueErrorオブジェクトを作成する役割を担っています。このメソッドは通常、第一引数としてクラス自身(cls)を受け取り、必要に応じてエラーメッセージなどの追加の引数を取ることがあります。そして、ValueErrorの基底クラスであるExceptionまたはobjectの__new__を呼び出すことで、新しいValueErrorインスタンスを生成し、そのインスタンスを返します。

開発者がValueErrorの__new__メソッドを直接呼び出してインスタンスを生成することは稀であり、通常はValueError(...)のようにクラスを直接呼び出すことで、内部的に__new__と__init__が自動的に実行されます。このメソッドは、Pythonのオブジェクト生成メカニズムの根幹をなすものであり、エラーハンドリングの基盤となる例外オブジェクトがどのように構築されるかを理解する上で重要です。

構文(syntax)

1def __new__(cls, *args, **kwargs):
2    ...

引数(parameters)

cls, /, *args, **kwargs

  • cls: このメソッドが呼び出されるクラス
  • /: これ以降の引数は位置引数としてのみ受け取ることを示す区切り文字
  • *args: 位置引数として渡される任意の引数
  • **kwargs: キーワード引数として渡される任意の引数

戻り値(return)

ValueError

このメソッドは、新しい ValueError オブジェクトを生成して返します。

関連コンテンツ