CKTIS / Python
property.setter — scrittura controllata di una proprietà
Con `property.setter`, una normale assegnazione a un attributo di istanza chiama una funzione che può convalidare il nuovo valore prima di salvarlo.
Versione: Python 3.12
Sintassi
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, @property crea una proprietà con una funzione di lettura (getter). property.setter è un metodo di un oggetto property esistente. Riceve una funzione di scrittura e restituisce una nuova proprietà con quella funzione come fset, mantenendo il getter e l’eventuale funzione di eliminazione. Non modifica l’oggetto originale.
Scrivi @priority.setter dopo il getter e chiama priority anche la funzione di scrittura. Nel corpo della classe, il risultato del decoratore viene associato al nome della funzione. Con un nome diverso, la nuova proprietà non sostituisce la proprietà priority originale.
Leggere task.priority chiama il getter. L’assegnazione task.priority = value chiama il setter passando l’istanza come self e il nuovo valore come value. Senza setter, l’assegnazione solleva AttributeError. Il setter non salva nulla automaticamente e l’assegnazione ne ignora il valore di ritorno.
Convalida il valore prima di salvarlo in un attributo distinto come self._priority. Assegnare a self.priority dentro il suo setter richiamerebbe il setter stesso. Il trattino basso iniziale è soltanto una convenzione: scrivere direttamente in _priority aggira la convalida.
Esempi
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)Risultato
2 ValueError 4
Il costruttore e le assegnazioni successive usano lo stesso setter, che accetta solo valori di tipo `int` da `1` a `5`. Assegnare `0` solleva `ValueError`; il programma intercetta l’eccezione e mostra che il valore salvato è ancora `4`.
Lezioni correlate
- Python · Lezione 2 · Avanzato · Versione: 5