Iterator Kustom

Python membuat sebuah class berperilaku seperti list dengan method ajaib seperti __len__, __getitem__, __contains__ dan __iter__. Godot memiliki method virtual hanya untuk salah satu tugas ini, yaitu perulangan for. Tiga method membuat for item in my_object: berfungsi:

• _iter_init(iter) dijalankan sekali, sebelum putaran pertama. Method ini menetapkan posisi awal dan mengembalikan true jika ada elemen pertama.
• _iter_get(position) mengembalikan elemen pada posisi saat ini, dan variabel perulangan mendapatkan nilai tersebut.
• _iter_next(iter) dijalankan sebelum setiap putaran berikutnya. Method ini berpindah ke posisi berikutnya dan mengembalikan false saat tidak ada lagi elemen, sehingga perulangan berakhir.

# 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 adalah array dengan satu slot yang dibuat Godot untuk setiap perulangan. iter[0] menyimpan posisi perulangan tersebut, dan Godot meneruskan nilainya ke _iter_get(). Kini, Team dapat digunakan dalam for loop:

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

Simpan posisi di iter[0], bukan di variabel anggota seperti _position. Setiap perulangan memiliki iter sendiri, jadi dua perulangan pada tim yang sama, bahkan jika salah satunya berada di dalam yang lain, tidak saling mengganggu. Dengan variabel anggota, perulangan bagian dalam akan menggeser posisi perulangan bagian luar.

Operasi list lainnya tidak memiliki method virtual: len(team) dan team[0] menghasilkan error. Tulis method biasa dengan nama seperti milik Array, misalnya size(), get_at(index), dan has(member). Jangan menguji keanggotaan dengan in: "Ada" in team memeriksa apakah Team memiliki property atau method bernama Ada, jadi hasilnya false.