Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Python

property.setter — kontrolowany zapis właściwości

Użyj `property.setter`, aby zwykłe przypisanie do atrybutu instancji uruchamiało funkcję, która sprawdza nową wartość przed jej zapisaniem.

Wersja: Python 3.12

Składnia

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)

W Pythonie 3.12 dekorator @property tworzy właściwość z funkcją odczytu, czyli getterem. property.setter to metoda istniejącego obiektu property. Przyjmuje funkcję zapisu i zwraca nowy obiekt property z tą funkcją jako fset, zachowując getter i ewentualną funkcję usuwania. Nie zmienia pierwotnego obiektu.

Umieść @priority.setter po getterze i nazwij funkcję zapisu również priority. W ciele klasy dekorator przypisuje zwróconą właściwość do nazwy definiowanej funkcji. Inna nazwa nie zastąpiłaby pierwotnej właściwości priority.

Odczyt task.priority wywołuje getter, a task.priority = value przekazuje instancję jako self i nową wartość jako value do settera. Bez settera przypisanie zgłasza AttributeError. Setter nie zapisuje wartości automatycznie, a przypisanie ignoruje jego wartość zwracaną.

Sprawdź wartość przed zapisem do osobnego atrybutu, np. self._priority. Przypisanie do self.priority wewnątrz settera wywołałoby go ponownie. Podkreślenie to tylko konwencja: bezpośredni zapis do _priority omija walidację.

Przykłady

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)

Wynik

2
ValueError
4

Konstruktor i późniejsze przypisanie korzystają z tego samego settera. Setter przyjmuje wyłącznie wartości typu `int` od `1` do `5`. Próba zapisania `0` zgłasza `ValueError`; program przechwytuje wyjątek i pokazuje, że nadal zapisana jest wartość `4`.

Powiązane lekcje

  • Python · Lekcja 2 · Zaawansowany · Wersja: 5

Źródła