CKTIS / Python
property.setter — toewijzingen aan een property beheren
Gebruik `property.setter` om bij een gewone toewijzing aan een instantieattribuut een functie aan te roepen die de nieuwe waarde vóór het opslaan kan controleren.
Versie: 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)In Python 3.12 maakt @property een property met een getter. property.setter is een methode van een bestaand property-object. Die methode neemt een schrijffunctie aan en geeft een nieuwe property terug met die functie als fset. De getter en een eventuele deleter blijven behouden. Het oorspronkelijke object verandert niet.
Plaats @priority.setter na de getter en noem de setterfunctie ook priority. In de klasse wordt het resultaat van de decorator aan de functienaam gekoppeld. Met een andere naam vervangt de nieuwe property de oorspronkelijke priority niet.
Bij het lezen van task.priority wordt de getter aangeroepen. task.priority = value roept de setter aan met de instantie als self en de nieuwe waarde als value. Zonder setter leidt de toewijzing tot AttributeError. De setter slaat niet automatisch iets op en de toewijzing negeert de retourwaarde.
Controleer de waarde voordat je die opslaat in een apart attribuut zoals self._priority. Een toewijzing aan self.priority in zijn eigen setter zou de setter opnieuw aanroepen. Het eerste onderstrepingsteken is slechts een conventie: rechtstreeks naar _priority schrijven omzeilt de controle.
Voorbeelden
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)Resultaat
2 ValueError 4
De constructor en latere toewijzingen gebruiken dezelfde setter. Die accepteert alleen waarden van het type `int` van `1` tot en met `5`. Toewijzing van `0` leidt tot `ValueError`; het programma vangt de uitzondering af en toont dat de opgeslagen waarde nog steeds `4` is.
Gerelateerde lessen
- Python · Les 2 · Gevorderd · Versie: 5