Pythonのproperty()とは？意味をわかりやすく簡単に解説

公開：2024年11月12日更新：2026年4月30日

CodeCampが提供するDX人材育成が可能なプログラミングやITが学べる公開講座

property()とは
property()の実装と活用方法
property()の基本的な使い方
デコレータを使用したproperty実装
property()の実践的な応用例

property()とは

Pythonのproperty()はクラス属性を、プロパティとして定義するための組み込み関数です。この関数を使用することでインスタンス変数へのアクセスをカプセル化し、ゲッターやセッターのような振る舞いを実現できます。

property()関数はgetterやsetter、deleterの3つの引数を受け取ることが可能。これらの引数にはそれぞれ属性の取得、設定、削除を行うメソッドを指定します。property()を使用することで属性へのアクセスを制御し、必要に応じて値の検証や変換を実行できるのです。

property()関数のメリットはクラスの外部からは通常の属性アクセスのように見えながら、内部では複雑な処理を行えることです。これによりコードの可読性が向上し、属性へのアクセス方法を変更する際にもクラスの利用者側のコードを変更する必要がなくなります。つまりproperty()は、柔軟性と保守性の高いコードを書くための強力なツールなのです。

Python研修一覧はこちら

目的に合うPython研修を一覧形式から探したい方は、ぜひご利用ください。

Python研修を比較する

Java研修一覧はこちら

目的に合うJava研修を一覧形式から探したい方は、ぜひご利用ください。

Java研修を比較する

PHP研修一覧はこちら

目的に合うPHP研修を一覧形式から探したい方は、ぜひご利用ください。

PHP研修を比較する

新入社員研修

目的に合う新入社員研修を一覧形式から探したい方は、ぜひご利用ください。

新入社員研修を比較する

全ての研修からも探したい方はこちら

property()の実装と活用方法

property()の実装と活用方法について、以下3つを簡単に解説します。

property()の基本的な使い方
デコレータを使用したproperty実装
property()の実践的な応用例

property()の基本的な使い方

property()関数は通常だとgetterやsetter、deleterの3つのメソッドを定義し、それらをproperty()関数の引数として渡すことでプロパティを作成します。この方法により属性へのアクセスを制御し、値の検証や変換を行うことが可能です。

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

    def get_radius(self):
        return self._radius

    def set_radius(self, value):
        if value < 0:
            raise ValueError("半径は正の値でなければなりません。")
        self._radius = value

    def del_radius(self):
        del self._radius

    radius = property(get_radius, set_radius, del_radius, "円の半径")

上記のコードはCircleクラスにradiusプロパティを定義している例です。get_radiusやset_radius、del_radiusメソッドを定義し、property()関数を使ってradiusプロパティを作成しています。これによりradiusの値を取得、設定、削除する際に特定の処理を実行できます。

property()を使用することで属性へのアクセスを制御しつつ、外部からは通常の属性のように扱うことができます。たとえばcircle = Circle(5)としてインスタンスを作成したあと、circle.radiusでradiusの値を取得したりcircle.radius = 10で値を設定したりできるのです。

Python基礎・実践(Django)

企業・法人向けのPython研修では、基礎から応用まで体系的に学べます。

Python研修の詳細

DX社員研修

企業・法人向けのDX研修では、実務に繋がるリスキリングでITレベルを向上させます。

DX研修の詳細

Javaエンジニア育成研修

企業・法人向けのJavaエンジニア育成研修では、Javaの基礎から応用まで確実に習得できます。

Java研修の詳細

新卒・新入社員向け研修

企業・法人に新入社員・新卒社員に向けたプログラミング研修を提供しています。

新入社員研修の詳細

コードキャンプのIT研修を全て見る

デコレータを使用したproperty実装

Pythonでは@propertyデコレータを使用し、プロパティを定義することもできます。この方法はよりPythonic（Python的）な書き方として広く使われており、コードの可読性を向上させられるのが魅力。@propertyデコレータを使用するとgetterやsetter、deleterをより直感的に定義できるのです。

class Rectangle:
    def __init__(self, width, height):
        self._width = width
        self._height = height

    @property
    def area(self):
        return self._width * self._height

    @property
    def width(self):
        return self._width

    @width.setter
    def width(self, value):
        if value < 0:
            raise ValueError("幅は正の値でなければなりません。")
        self._width = value

上記のコードではRectangleクラスに、areaとwidthの2つのプロパティを定義している例です。areaプロパティは読み取り専用で、widthプロパティは読み書き可能です。@propertyデコレータを使用することで、メソッド名をプロパティ名として直接使用できるようになります。

デコレータを使用したプロパティ定義のメリットはコードがより簡潔になり、プロパティの役割がより明確になることです。たとえばrect = Rectangle(5, 3)としてインスタンスを作成したあと、rect.areaで面積を取得したりrect.width = 10で幅を設定したりできます。このアプローチは特に複雑なクラスを設計する際に有効です。

property()の実践的な応用例

property()はデータの検証や計算プロパティ、遅延評価などさまざまな場面で活用できます。たとえば温度変換を行うクラスを実装する際、摂氏温度と華氏温度を自動的に変換するプロパティを定義できます。これによりユーザーは温度単位を意識することなく、適切な変換が行われるようになるのです。

class Temperature:
    def __init__(self, celsius=0):
        self._celsius = celsius

    @property
    def celsius(self):
        return self._celsius

    @celsius.setter
    def celsius(self, value):
        if value < -273.15:
            raise ValueError("絶対零度より低い温度は存在しません。")
        self._celsius = value

    @property
    def fahrenheit(self):
        return (self._celsius * 9/5) + 32

    @fahrenheit.setter
    def fahrenheit(self, value):
        self.celsius = (value - 32) * 5/9

このTemperatureクラスでは、celsiusとfahrenheitの2つのプロパティを定義しています。celsiusプロパティでは設定時に値の検証を行い、物理的に不可能な温度を防いでいるのがポイントです。一方、fahrenheitプロパティは計算プロパティとして実装されており、摂氏温度から華氏温度への変換を自動的に行います。

property()の実践的な応用により、コードの再利用性と保守性が向上します。たとえばtemp = Temperature(25)としてインスタンスを作成したあと、temp.fahrenheitで華氏温度を取得したりtemp.fahrenheit = 68で摂氏温度を自動的に設定したりすることが可能。このようにproperty()を活用することで、より柔軟で使いやすいクラスを設計することが可能です。

※上記コンテンツの内容やソースコードはAIで確認・デバッグしておりますが、間違いやエラー、脆弱性などがある場合は、コメントよりご報告いただけますと幸いです。