Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Python

property.setter — riadený zápis do vlastnosti

Pomocou `property.setter` môže bežné priradenie do atribútu inštancie zavolať funkciu, ktorá novú hodnotu skontroluje skôr, než ju uloží.

Verzia: Python 3.12

Syntax

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)

V Pythone 3.12 vytvorí @property vlastnosť s funkciou na čítanie (getterom). property.setter je metóda existujúceho objektu property. Prijíma funkciu na zápis a vracia novú vlastnosť s touto funkciou ako fset. Getter aj prípadná funkcia na odstránenie zostanú zachované. Pôvodný objekt sa nezmení.

Umiestnite @priority.setter za getter a funkciu na zápis tiež pomenujte priority. V tele triedy sa výsledok dekorátora priradí k názvu funkcie. Pri inom názve nová vlastnosť nenahradí pôvodnú vlastnosť priority.

Čítanie task.priority zavolá getter. Priradenie task.priority = value zavolá setter s inštanciou ako self a novou hodnotou ako value. Bez settera priradenie vyvolá AttributeError. Setter nič neukladá automaticky a priradenie ignoruje jeho návratovú hodnotu.

Hodnotu skontrolujte pred uložením do samostatného atribútu, napríklad self._priority. Priradenie do self.priority v jeho vlastnom setteri by setter zavolalo znova. Úvodné podčiarknutie je len konvencia: priamy zápis do _priority obchádza kontrolu.

Príklady

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)

Výsledok

2
ValueError
4

Konštruktor aj neskoršie priradenia používajú rovnaký setter. Prijíma len hodnoty typu `int` od `1` do `5`. Priradenie hodnoty `0` vyvolá `ValueError`; program výnimku zachytí a ukáže, že uložená hodnota je stále `4`.

Súvisiace lekcie

  • Python · Lekcia 2 · Pokročilá · Verzia: 5

Zdroje