【Python3.x】AnnAssign::__new__()メソッドの使い方
__new__メソッドの使い方について、初心者にもわかりやすく解説します。
基本的な使い方
__new__メソッドは、新しいオブジェクトのインスタンスを生成するメソッドです。Pythonでクラスのインスタンスを作成する際、例えばMyClass()のようにクラス名を呼び出すと、まず最初にこの__new__メソッドが自動的に実行されます。このメソッドの主な役割は、メモリ上に新しいオブジェクトの領域を確保し、そのインスタンスを作成することです。
__new__メソッドは、最初の引数として自身のクラスオブジェクト(慣例としてclsという名前で受け取られます)を受け取り、その後にインスタンス生成時に渡された他の全ての引数を受け取ります。そして、最終的に生成された新しいオブジェクトのインスタンスを返します。通常、このメソッドの実装では、基底クラス(例えばobjectクラス)の__new__メソッドを呼び出して実際のインスタンス生成を行い、その結果を返却します。
Pythonのオブジェクト生成プロセスにおいて、__new__メソッドはインスタンスそのものを生成するのに対し、__init__メソッドは生成されたインスタンスの初期化、つまり属性に初期値を設定する役割を担います。したがって、__new__は__init__よりも必ず先に呼び出されるという特徴があります。
このメソッドを直接オーバーライドすることは稀ですが、特定の高度なシナリオで利用されます。例えば、クラスが常に同じインスタンスを返すようにするシングルトンデザインパターンを実装する場合や、オブジェクトの生成プロセスをフックして、既存のオブジェクトを再利用したり、プロキシオブジェクトを返したりする場合などに利用されます。システムエンジニアを目指す上で、普段直接触れる機会は少ないかもしれませんが、Pythonのオブジェクト指向の深い仕組みを理解する上で重要な概念の一つです。
構文(syntax)
1class AnnAssign: 2 def __new__(cls, *args, **kwargs): 3 instance = super().__new__(cls) 4 return instance
引数(parameters)
cls, target: ast.expr, annotation: ast.expr, value: Optional[ast.expr] = None, simple: int = 0, *, lineno: Optional[int] = None, col_offset: Optional[int] = None, end_lineno: Optional[int] = None, end_col_offset: Optional[int] = None
- cls: AnnAssignオブジェクトを生成するためのクラス
- target: 代入される変数や属性などの式
- annotation: 変数や属性に付与される型アノテーション
- value = None: 代入される値(省略可能、デフォルトはNone)
- simple = 0: アノテーションの単純さを示す整数(デフォルトは0)
- lineno = None: アノテーションの開始行番号(省略可能)
- col_offset = None: アノテーションの開始列オフセット(省略可能)
- end_lineno = None: アノテーションの終了行番号(省略可能)
- end_col_offset = None: アノテーションの終了列オフセット(省略可能)
戻り値(return)
AnnAssign
__new__ メソッドは、新しい AnnAssign オブジェクトのインスタンスを生成して返します。