HOWTO · Python
Python でクラスグローバル変数を定義する
Python のクラス属性をクラス本体で定義し、ClassName.attribute でアクセスする方法と、global で宣言されたモジュールレベルの名前との区別を学びます。
このページの内容
Pythonのクラス変数は、クラス本体で代入する属性です。クラスに一度定義し、Tesla.speed のように ClassName.attribute で参照します。global で宣言する名前は別のもので、モジュールの名前空間に属し、クラス属性にはなりません。
Pythonでクラス変数を定義する
値をクラス本体で代入し、クラス名を使って参照します。この例では、メソッドと別のクラスから同じ属性を参照する方法も示します。
class Tesla:
speed = 60
def show_speed(self):
return Tesla.speed
class Dashboard:
def show_tesla_speed(self):
return Tesla.speed
print(Tesla.speed)
print(Tesla().show_speed())
print(Dashboard().show_tesla_speed())
60
60
60
ここでは speed は Tesla に格納されるため、Tesla.speed で共有クラス属性を参照できます。Tesla のメソッドと Dashboard のメソッドは、どちらも同じクラス名を使った参照方法を用います。
クラスの外からクラス変数にアクセスする
クラスを参照できる場所なら、どこでも ClassName.attribute を使えます。たとえば、モジュールレベルのコードや別のクラスのメソッドから Tesla.speed を参照できます。クラス属性を読むためにインスタンスを作る必要はありません。クラスの外で speed のような裸の名前を使っても、それは Tesla.speed を指しません。現在のスコープで名前が検索され、定義されていない場合もあります。
インスタンスにも同じ名前の属性を定義できます。たとえば car.speed = 80 は、その car だけに属性を設定します。一方、Tesla.speed は引き続きクラス属性を参照します。共有される値が必要な場合は、クラス名を付けて参照してください。
global ではクラス変数を定義できない理由
global 文は、コードブロック内で裸の名前に代入すると、その名前をモジュールの名前空間に束縛することを Python に伝えます。クラス本体で global speed の後に speed = 60 と書くと、モジュールレベルの名前 speed が作成または更新されます。Tesla.speed が設定されるわけではありません。クラス変数を定義するには、global を使わずにクラス本体で speed = 60 のように代入し、クラスの外では Tesla.speed として参照します。
クラス属性を使うメソッドでも Tesla.speed を参照できます。サブクラスでも動作させたい場合は、意図する検索動作に応じて type(self).speed または self.speed を使います。self.speed は、クラス属性を隠すインスタンス属性を参照することがあります。