Validazione con i setter

Un setter viene eseguito ogni volta che viene assegnato un valore alla sua proprietà, perciò è il punto in cui controllare il nuovo valore. Python genera un errore per un valore non valido. GDScript non ha eccezioni, quindi un setter fa invece una di queste cose: limita il valore all'intervallo consentito oppure mantiene il valore precedente e registra cosa è andato storto.

# character.gd
class_name Character
extends RefCounted

var last_error: String = ""
var hp: int = 100:
	set(value):
		hp = clampi(value, 0, 100)
var nickname: String = "Player":
	set(value):
		if value.length() < 3:
			last_error = "Name too short"
			return
		last_error = ""
		nickname = value

clampi(value, 0, 100) restituisce value riportato nell’intervallo da 0 a 100. Nel setter di nickname, return esce prima dell’assegnazione, quindi il vecchio nome rimane e last_error spiega perché:

# main.gd
var hero := Character.new()
hero.hp = 250
print(hero.hp) # 100
hero.nickname = "Al"
print(hero.nickname) # Player
print(hero.last_error) # Nome troppo corto
hero.nickname = "Alice"
print(hero.nickname) # Alice

Il setter viene eseguito anche per le assegnazioni all'interno della classe, in _init() e in ogni metodo. Assegna gli argomenti del costruttore tramite la proprietà e verranno controllati anche loro:

func _init(start_hp: int) -> void:
	hp = start_hp # esegue il setter: Character.new(500) inizia con 100

All'interno del setter stesso, assegnare hp memorizza il valore senza richiamare il setter. L'unica assegnazione che ignora il setter è il valore iniziale nella dichiarazione (= 100), quindi quel valore deve essere valido di per sé.