2021.02.07 2025.11.13

【Python】クラスのプロパティ（property）の使い方

naoki-hn

Python のクラスにおけるプロパティ（property）について解説します。

1 Python のクラスのプロパティ
- 1.1 プロパティとは
- 1.2 プロパティの基本的な使い方
  - 1.2.1 ゲッターとセッターの定義
  - 1.2.2 プロパティのメリット
2 まとめ

Python のクラスのプロパティ

オブジェクト指向プログラミングの重要な概念はカプセル化です。カプセル化は、外部から直接アクセスできないように変数を隠ぺいし、必要な情報だけを公開する仕組みです。これにより、意図しない変数操作や予期しないバグを防ぐことが可能です。

Python においてカプセル化に重要なものが「プロパティ（property）」です。この記事では、Python のクラスにおけるプロパティついて紹介します。

プロパティとは

他の言語（C 言語や Java など）では get_xxx や set_xxx といったアクセサリーメソッドで変数の値を取得・設定することが一般的です。前者をゲッター、後者をセッターと言います。

一方で、Python では property デコレータを使用することで、変数のように見えるが内部ではメソッドとして動作するようなプロパティを作成できます。これにより、より直感的なコードを書くことが可能です。

プロパティのためのメソッド定義は具体的には以下のようになります。

ゲッター：@property デコレータを記載する。
セッター：@<プロパティ名>.setter デコレータを記載する。

デコレータはメソッドに機能を付与する仕組みです。デコレータについては「デコレータの基本的な使い方」を参考にしてください。

プロパティの基本的な使い方

ここからは具体的な例でプロパティの使い方を紹介します。

class Person:
    def __init__(self, first_name=None, last_name=None, age=None):
        self.__first_name = first_name
        self.__last_name = last_name
        self.__age = age

    @property
    def first_name(self):
        return self.__first_name

    @property
    def last_name(self):
        return self.__last_name

    @property
    def age(self):
        return self.__age

    @first_name.setter
    def first_name(self, value):
        self.__first_name = value

    @last_name.setter
    def last_name(self, value):
        self.__last_name = value

    @age.setter
    def age(self, value):
        if value >= 0:
            self.__age = value
        else:
            raise ValueError(
                "Only values greater than or equal to 0 are allowed."
            )

    def myname(self):
        print(f"私の名前は、{self.__last_name}{self.__first_name}、{self.__age}歳です。")


def main():
    person1 = Person("太郎", "田中", 20)
    print(person1.first_name)
    print(person1.last_name)
    print(person1.age)
    person1.myname()
    print("===")

    person1.first_name = "次郎"
    person1.last_name = "佐藤"
    person1.age = 15
    print(person1.first_name)
    print(person1.last_name)
    print(person1.age)
    person1.myname()


if __name__ == "__main__":
    main()

【実行結果】
太郎
田中
20
私の名前は、田中太郎、20歳です。
===
次郎
佐藤
15
私の名前は、佐藤次郎、15歳です。

上記では、インスタンス変数を「__」（アンダースコア × 2 個）を付けた変数名で定義しています。このような変数は Python では外部から直接参照できません。

しかし、例では、アクセス時に「person1.first_name」、値の変更時には「person1.firstname = "次郎"」のように直感的にアクセスできています。これは、プロパティによってゲッターとセッターに関するメソッドを定義しているためです。

ゲッターとセッターの定義

ゲッター

@property デコレータを使って定義します。以下は __first_name の値を取得するゲッターのメソッド定義の部分です。

    @property
    def first_name(self):
        return self.__first_name

セッター

@プロパティ名.setter デコレータを使って定義します。値の設定時に追加ロジックを組み込むことも可能です。以下は、age プロパティを取得する際に、年齢が 0 以上かどうかをチェックしています。

    @age.setter
    def age(self, value):
        if value >= 0:
            self.__age = value
        else:
            raise ValueError(
                "Only values greater than or equal to 0 are allowed."
            )

プロパティのメリット

直感的な操作：person.first_name といった形で変数のようにアクセスできるため、コードの可読性が向上します。
カプセル化：外部からの変数への直接アクセスを防ぎ、内部ロジックでアクセスをコントロールできます。例えば、値の範囲をチェックして不正な値が設定されないようにするなどの追加機能も簡単に実装可能です。