Własne iteratory

Python sprawia, że klasa zachowuje się jak lista dzięki specjalnym metodom, takim jak __len__, __getitem__, __contains__ i __iter__. Godot udostępnia metody wirtualne tylko dla jednego z tych zastosowań: pętli for. Trzy metody sprawiają, że działa zapis for item in my_object::

• _iter_init(iter) uruchamia się raz, przed pierwszym przebiegiem. Ustawia pozycję początkową i zwraca true, jeśli istnieje pierwszy element.
• _iter_get(position) zwraca element z bieżącej pozycji, a zmienna pętli otrzymuje tę wartość.
• _iter_next(iter) uruchamia się przed każdym kolejnym przebiegiem. Przechodzi do następnej pozycji i zwraca false, gdy nie ma już więcej elementów, co kończy pętlę.

# 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 to tablica z jednym miejscem, którą Godot tworzy dla każdej pętli. iter[0] przechowuje pozycję tej pętli, a Godot przekazuje jej wartość do _iter_get(). Team działa teraz w pętli for:

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

Przechowuj pozycję w iter[0], a nie w zmiennej składowej takiej jak _position. Każda pętla ma własne iter, więc dwie pętle przechodzące po tej samej drużynie, nawet gdy jedna znajduje się wewnątrz drugiej, nie zakłócają się nawzajem. W przypadku zmiennej składowej pętla wewnętrzna zmieniałaby pozycję pętli zewnętrznej.

Pozostałe operacje na listach nie mają wirtualnej metody: len(team) i team[0] są błędami. Napisz zwykłe metody o nazwach takich jak w przypadku tablicy, na przykład size(), get_at(index) i has(member). Nie sprawdzaj przynależności za pomocą in: "Ada" in team sprawdza, czy Team ma właściwość lub metodę o nazwie Ada, więc zwraca false.