【Python入門】Pythonのproperty関数とは？使い方と活用方法を徹底解説（Python 3.11）

はじめに
property関数とは？
property関数の基本構文
property関数の使用例
property関数の応用例
- 計算プロパティの実装
まとめ

はじめに

Pythonにはオブジェクト指向プログラミングを強力にサポートするさまざまな機能があります。その中でも property 関数は、カプセル化を実現する便利な機能の一つです。

本記事では、 property 関数の基本的な使い方から応用例まで、Python 3.11 に基づいて詳しく解説します。

property関数とは？

property 関数は、Pythonの組み込み関数で、クラスの属性をカプセル化し、ゲッター、セッター、デリーターを定義するのに使われます。これにより、外部からのアクセス制限や処理の追加が容易になります。

例えば、クラスのインスタンス変数に直接アクセスさせず、メソッドを通じてアクセスを制御することで、データの整合性を保つことができます。

property関数の基本構文

property 関数は以下のような構文で使用します。

property(fget=None, fset=None, fdel=None, doc=None)

fget: ゲッターメソッド（値を取得する関数）
fset: セッターメソッド（値を設定する関数）
fdel: デリーターメソッド（値を削除する関数）
doc: プロパティのドキュメント文字列

これを利用して、オブジェクトの属性をカプセル化できます。

property関数の使用例

以下は property 関数を使った基本的な例です。

class Person:
    def __init__(self, name):
        self._name = name  # プライベート変数として定義

    @property
    def name(self):
        """名前を取得するゲッター"""
        return self._name

    @name.setter
    def name(self, value):
        """名前を設定するセッター"""
        if not isinstance(value, str):
            raise ValueError("名前は文字列である必要があります")
        self._name = value

    @name.deleter
    def name(self):
        """名前を削除するデリーター"""
        del self._name

# 使用例
p = Person("太郎")
print(p.name)  # "太郎"
p.name = "花子"
print(p.name)  # "花子"
del p.name

このように、property デコレーターを使うことで、オブジェクトの属性へのアクセスを制御できます。

property関数の応用例

計算プロパティの実装

property を使うと、オブジェクトの属性を計算結果として返すことも可能です。

class Circle:
    def __init__(self, radius):
        self._radius = radius

    @property
    def radius(self):
        return self._radius

    @radius.setter
    def radius(self, value):
        if value <= 0:
            raise ValueError("半径は正の数である必要があります")
        self._radius = value

    @property
    def area(self):
        """面積を計算して返すプロパティ"""
        import math
        return math.pi * self._radius ** 2

# 使用例
c = Circle(3)
print(c.area)  # 28.274333882308138
c.radius = 5
print(c.area)  # 78.53981633974483

このように property を使うことで、オブジェクトの状態に基づいて計算結果を返すプロパティを作成できます。