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

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

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

作成日: 更新日:

基本的な使い方

__new__メソッドは、クラスの新しいインスタンス(オブジェクト)を生成する際に、__init__メソッドよりも先に呼び出される特殊なメソッドです。具体的には、UserWarningクラスにおいて、この__new__メソッドは、ユーザーへの警告メッセージを表すUserWarningオブジェクトを実際にメモリ上に作成する役割を実行します。

Pythonでは、クラスからオブジェクトが作られるとき、まず__new__メソッドが呼び出され、そのクラスの新しいインスタンスが生成されます。このメソッドは、生成されたインスタンスそのものを戻り値として返します。その後、もし__new__メソッドが現在のクラスのインスタンスを返した場合に限り、返されたインスタンスに対して__init__メソッドが呼び出され、そのインスタンスの初期設定が行われます。

UserWarningのような組み込みの警告クラスでは、通常、この__new__メソッドは、特別なカスタマイズを必要とせず、親クラスであるobjectクラスの__new__メソッドを呼び出して、標準的な方法で新しい警告オブジェクトを生成します。つまり、UserWarningオブジェクトが作られる際に必要な基盤を整え、警告メッセージを保持できる「入れ物」を作り出すのが__new__メソッドの役割です。開発者が独自のクラスで__new__メソッドをオーバーライドする場合、インスタンスの生成方法を細かく制御したり、既に存在するインスタンスを返したりするなど、特殊な振る舞いを実装することができますが、通常のクラスでは明示的に定義することは少ないです。これは、オブジェクト生成の最も根源的な部分を担う重要なメソッドです。

構文(syntax)

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

引数(parameters)

cls, *args, **kwargs

  • cls: 新しく作成されるインスタンスのクラス
  • *args: 位置引数
  • **kwargs: キーワード引数

戻り値(return)

UserWarning

このメソッドは、UserWarningクラスの新しいインスタンスを生成して返します。

関連コンテンツ