Pythonの組み込みクラス属性とは？__dict__や__doc__などの主要属性をわかりやすく解説

Pythonの組み込みクラス属性（Built-in Class Attributes）とは

Pythonでは、クラスを定義すると、明示的に宣言しなくても自動的に用意される「組み込みクラス属性」がいくつか存在します。これらは通常の属性と同じように、ドット（.）演算子を使って classname.__dict__ の形式でアクセスできます。

本記事では、Python公式ドキュメントに記載されている代表的な組み込みクラス属性を一つずつ解説します。

主な組み込みクラス属性の一覧

1. __dict__：クラスの名前空間

__dict__ は、そのクラスが持つ名前空間（namespace）を格納した辞書型の属性です。クラス内で定義されたメソッドや変数などの情報がこの辞書に収められています。

2. __doc__：クラスのドキュメンテーション文字列

__doc__ には、クラス定義時に記述したdocstring（ドキュメンテーション文字列）が格納されます。docstringが定義されていない場合は None となります。

3. __name__：クラス名

__name__ は、クラスの名前を文字列として返す属性です。動的に生成したオブジェクトから元のクラス名を確認したい場合などに便利です。

4. __module__：クラスが定義されているモジュール名

__module__ は、そのクラスがどのモジュールで定義されたかを示す属性です。対話モード（インタラクティブシェル）で実行した場合、この属性の値は "__main__" になります。

5. __bases__：基底クラス（親クラス）のタプル

__bases__ は、継承元となった基底クラスを格納するタプルです。タプル内の順序は、クラス定義時の基底クラスリストにおける出現順と一致します。継承関係を持たないクラスの場合、このタプルは空になる可能性があります。

実行例で確認してみよう

以下のコードで、実際に組み込みクラス属性へアクセスする様子を確認できます。

class SampleClass:
    """これはサンプルクラスです。"""
    pass

print(SampleClass.__doc__)     # これはサンプルクラスです。
print(SampleClass.__name__)    # SampleClass
print(SampleClass.__module__)  # __main__
print(SampleClass.__bases__)   # (<class 'object'>,)
print(SampleClass.__dict__)    # クラスの名前空間を含む辞書が出力される

まとめ

組み込みクラス属性を活用することで、クラスの構造や継承関係、定義場所などの情報をプログラムから動的に取得できます。デバッグやリフレクション処理、メタプログラミングを行う際に非常に役立つため、ぜひ覚えておきましょう。