База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Python

property.setter — контролиран запис в свойство

С `property.setter` обикновеното присвояване на атрибут на инстанция извиква функция, която може да провери новата стойност, преди да я запише.

Версия: Python 3.12

Синтаксис

class Task:
    @property
    def priority(self):
        return self._priority

    @priority.setter
    def priority(self, value):
        self._priority = value

# Functional form for an existing property p and a setter function set_priority:
# p = p.setter(set_priority)

В Python 3.12 @property създава свойство с функция за четене (гетър). property.setter е метод на съществуващ обект property. Той приема функция за запис и връща ново свойство с тази функция като fset, като запазва гетъра и функцията за изтриване, ако има такава. Първоначалният обект не се променя.

Постави @priority.setter след гетъра и наречи функцията за запис също priority. В тялото на класа резултатът от декоратора се свързва с името на функцията. При друго име новото свойство няма да замени първоначалното свойство priority.

Четенето на task.priority извиква гетъра. Присвояването task.priority = value извиква сетъра с инстанцията като self и новата стойност като value. Без сетър присвояването предизвиква AttributeError. Сетърът не записва нищо автоматично, а присвояването пренебрегва върнатата от него стойност.

Провери стойността, преди да я запишеш в отделен атрибут като self._priority. Присвояване на self.priority в собствения му сетър би извикало сетъра отново. Началната долна черта е само условност: директният запис в _priority заобикаля проверката.

Примери

class Task:
    def __init__(self, priority):
        self.priority = priority

    @property
    def priority(self):
        return self._priority

    @priority.setter
    def priority(self, value):
        if type(value) is not int:
            raise TypeError("priority must be an int")
        if not 1 <= value <= 5:
            raise ValueError("priority must be between 1 and 5")
        self._priority = value


task = Task(2)
print(task.priority)
task.priority = 4
try:
    task.priority = 0
except ValueError:
    print("ValueError")
print(task.priority)

Резултат

2
ValueError
4

Конструкторът и по-късните присвоявания използват един и същ сетър. Той приема само стойности от тип `int` от `1` до `5`. Присвояването на `0` предизвиква `ValueError`; програмата прихваща изключението и показва, че записаната стойност остава `4`.

Свързани уроци

  • Python · Урок 2 · Напреднало · Версия: 5

Източници