Signaux avec arguments

Un signal peut transporter des valeurs. Indique-les dans la déclaration, comme les paramètres d’une fonction :

signal damaged(amount: int, hp_left: int)
signal died

Transmets les valeurs à emit() dans le même ordre :

func take_damage(amount: int) -> void:
	hp = maxi(hp - amount, 0)
	damaged.emit(amount, hp)
	if hp == 0:
		died.emit()

Une fonction connectée reçoit les valeurs en tant que paramètres. Elle a donc besoin d’un paramètre par valeur :

hero.damaged.connect(_on_hero_damaged)

func _on_hero_damaged(amount: int, hp_left: int) -> void:
	print("-%d HP, %d left" % [amount, hp_left])

Les types dans la déclaration documentent les valeurs : GDScript ne les vérifie pas lors de l’émission. Une incompatibilité apparaît dans la fonction réceptrice. Une fonction qui n’a pas le bon nombre de paramètres, ou un paramètre typé qui ne peut pas contenir la valeur, provoque une erreur à la ligne emit(), et cette fonction ne s’exécute pas.

bind() ajoute vos propres valeurs après celles émises. Une méthode peut alors écouter plusieurs héros tout en sachant lequel a été touché :

ada.damaged.connect(_on_damaged.bind("Ada"))
bo.damaged.connect(_on_damaged.bind("Bo"))

func _on_damaged(amount: int, hp_left: int, who: String) -> void:
	print(who, " lost ", amount, " HP")

Les arguments fournissent à un écouteur les données dont il a besoin, afin qu’il n’ait pas à les lire depuis l’émetteur. Ne connectez jamais une lambda qui utilise l’objet émetteur lui-même, comme hero.died.connect(func(): print(hero.hp)) : la lambda maintient hero en vie, hero maintient la lambda, aucun des deux n’est jamais libéré, et Godot signale des instances ayant fui lorsque le programme se termine.