Pythonのclassmethod（クラスメソッド）とは？使い方とコード例を解説

Pythonのclassmethod（クラスメソッド）とは

クラスメソッドは、第一引数としてクラス自身を受け取る特殊なメソッドです。この仕組みにより、クラスからインスタンス（オブジェクト）を生成しなくても、クラスに属するメソッドを直接呼び出すことができます。

使い方は非常にシンプルで、クラス内のメソッド宣言の直前にデコレータ @classmethod を付けるだけです。こうすることで、そのメソッドに直接アクセスできるようになります。

クラスメソッドの主な特徴は以下の通りです。

• クラスメソッドはクラスに紐付けられており、利用するためにクラスのインスタンス化に依存しません。
• クラスメソッドからクラスの状態（クラス変数など）を変更すると、その変更はすべてのインスタンスに波及します。

classmethodの基本的な使い方

次の例では、WeekDay というクラスを作成し、その中に daynames というメソッドを定義しています。そして、クラスをインスタンス化せずに（つまりオブジェクトを生成せずに）このメソッドへアクセスしています。

コード例

class WeekDay:
    day_name = ['Mon', 'Tue', 'Wed', 'Thu', 'Fri']

    # クラスメソッドの適用
    @classmethod
    def daynames(cls):
        print('The WeekDays are', cls.day_name)

WeekDay.daynames()
# または
WeekDay().daynames()

実行結果

上記のコードを実行すると、次のような出力が得られます。

The WeekDays are ['Mon', 'Tue', 'Wed', 'Thu', 'Fri']
The WeekDays are ['Mon', 'Tue', 'Wed', 'Thu', 'Fri']

なお、慣例としてクラスメソッドの第一引数には cls を使うのが一般的です。WeekDay.daynames() のようにクラスから直接呼び出した場合も、WeekDay().daynames() のようにインスタンス経由で呼び出した場合も、同じ結果になる点に注目してください。

classmethodを使わない場合との比較

同じ結果は、クラスメソッドを使わずにクラス外へ関数を定義することでも得られます。しかし、この方法ではデータと処理が分離してしまい、コードのまとまりが失われます。こここそが、クラスメソッドが必要とされる理由です。

コード例

def daynames():
    day_name = ['Mon', 'Tue', 'Wed', 'Thu', 'Fri']
    print('The WeekDays are', day_name)

daynames()

実行結果

上記のコードを実行すると、次のような出力が得られます。

The WeekDays are ['Mon', 'Tue', 'Wed', 'Thu', 'Fri']

まとめ

クラスメソッドは、インスタンス化せずにクラスレベルで動作するメソッドを定義したい場合に便利です。特に、代替コンストラクタ（ファクトリメソッド）やクラス全体に関わる設定の管理などでよく活用されます。第一引数 cls を通じてクラス自身にアクセスできる点が、通常のインスタンスメソッドとの大きな違いです。