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

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

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

作成日: 更新日:

基本的な使い方

__new__メソッドは、Pythonのクラスにおいて新しいインスタンスを生成する際に最初に呼び出される特別なメソッドです。これは、実際にオブジェクトがメモリ上に作成される「前段階」を担当し、インスタンスそのものを作り出す役割を担っています。

Pythonでは、インスタンスの生成と初期化という二つの段階があります。__new__メソッドがまず新しいインスタンスを作成し、その後に作成されたインスタンスを引数として__init__メソッドが呼び出され、インスタンスの初期設定を行うという流れになります。つまり、__new__は「オブジェクトを生成する」、__init__は「生成されたオブジェクトを初期化する」という異なる目的を持っています。

このメソッドは、常に最初の引数としてそのクラス自身(慣習的にclsと名付けられます)を受け取り、その後にインスタンス化時に渡された他の引数が続きます。そして、必ず新しいインスタンスを返す必要があります。通常は、super().__new__(cls, *args, **kwargs)のように親クラスの__new__メソッドを呼び出して、インスタンスの生成を親に委譲します。

一般的に、通常のクラスで__new__メソッドを明示的にオーバーライドすることはあまりありません。しかし、例えば、変更不可能なオブジェクト(文字列や数値など)のサブクラスを作成する場合や、特定の条件に基づいて異なる種類のインスタンスを返すような高度なファクトリパターンを実装する際に利用されます。__new__メソッドは、オブジェクトのライフサイクルにおけるインスタンス生成の根幹を制御する、非常に強力なメカニズムです。

構文(syntax)

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

引数(parameters)

cls: type, *args: Any, **kwargs: Any

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

戻り値(return)

object

__new__ メソッドは、新しいインスタンスを生成し、そのインスタンスを返します。

関連コンテンツ