Guardas de coincidencia

Una guarda añade una condición a un patrón. Escribe when y una condición después del patrón: el patrón coincide solo si el valor se ajusta al patrón y la condición es true. Las guardas existen desde Godot 4.4.

var hp := 15
match hp:
	0:
		print("Defeated")
	var h when h < 20:
		print("Low health: ", h)
	_:
		print("Healthy")

Low health: 15

GDScript no tiene patrones de rango como 1..10. Un patrón de vinculación con una condición de guarda cumple esa función: var h when h < 20: coincide con todos los valores inferiores a 20 y los asigna a h.

Cuando una guarda es false, match continúa con el siguiente patrón. Los patrones se prueban de arriba abajo, así que el orden determina qué bloque se ejecuta:

var temp := 32
match temp:
	var t when t <= 0:
		print("Freezing")
	var t when t < 15:
		print("Cold")
	var t when t < 30:
		print("Warm")
	_:
		print("Hot")

Hot

El segundo patrón no necesita t > 0: una temperatura de 0 o inferior ya coincidía con el primero. Una guarda puede usar cualquier condición, con otras variables y and u or, y encaja con cualquier patrón: 5 when hard_mode: coincide con 5 solo mientras hard_mode sea true.