Iteradores personalizados

Python permite que una clase se comporte como una lista con métodos mágicos como __len__, __getitem__, __contains__ y __iter__. Godot tiene métodos virtuales para solo una de estas tareas: el bucle for. Tres métodos hacen que for item in my_object: funcione:

• _iter_init(iter) se ejecuta una vez, antes de la primera iteración. Establece la posición inicial y devuelve true si hay un primer elemento.
• _iter_get(position) devuelve el elemento en la posición actual, y la variable del bucle recibe ese valor.
• _iter_next(iter) se ejecuta antes de cada iteración posterior. Avanza a la siguiente posición y devuelve false cuando no quedan más elementos, lo que finaliza el bucle.

# team.gd
class_name Team
extends RefCounted

var _members: Array[String] = []

func add(member: String) -> void:
	_members.append(member)

func _iter_init(iter: Array) -> bool:
	iter[0] = 0
	return iter[0] < _members.size()

func _iter_next(iter: Array) -> bool:
	iter[0] += 1
	return iter[0] < _members.size()

func _iter_get(position):
	return _members[position]

iter es un Array con un espacio que Godot crea para cada bucle. iter[0] contiene la posición de ese bucle, y Godot pasa su valor a _iter_get(). Ahora, un Team funciona en un bucle for:

var team := Team.new()
team.add("Ada")
team.add("Bo")
for member in team:
	print(member) # Ada, luego Bo

Mantén la posición en iter[0], no en una variable miembro como _position. Cada bucle tiene su propio iter, así que dos bucles sobre el mismo equipo, incluso uno dentro del otro, no interfieren entre sí. Con una variable miembro, el bucle interno movería la posición del bucle externo.

Las demás operaciones de lista no tienen un método virtual: len(team) y team[0] son errores. Escribe métodos ordinarios con nombres como los de Array, por ejemplo, size(), get_at(index) y has(member). No compruebes la pertenencia con in: "Ada" in team comprueba si Team tiene una propiedad o un método llamado Ada, así que es false.