Classes internes

Une classe peut déclarer une autre classe à l’intérieur, avec le mot-clé class, un nom et un corps indenté. Cette classe interne est un type auxiliaire qui appartient à la classe externe :

# inventory.gd
class_name Inventory
extends RefCounted

const MAX_STACK := 5

class Slot:
	var item_name: String
	var count: int

	func _init(new_name: String, new_count: int) -> void:
		item_name = new_name
		count = mini(new_count, MAX_STACK)

	func _to_string() -> String:
		return "%s x%d" % [item_name, count]

var slots: Array[Slot] = []

func add(item_name: String, count: int) -> Slot:
	var slot := Slot.new(item_name, count)
	slots.append(slot)
	return slot

Dans inventory.gd, la classe interne est Slot. Tous les autres fichiers y accèdent par l’intermédiaire de la classe externe : Inventory.Slot.

# main.gd
var bag := Inventory.new()
bag.add("Potion", 9)
var arrows: Inventory.Slot = bag.add("Arrow", 3)
print(bag.slots)    # [Potion x5, Arrow x3]
var gem := Inventory.Slot.new("Gem", 1)

Une classe interne sans extends hérite de RefCounted, et elle peut avoir des variables, un constructeur et des méthodes comme n’importe quelle classe. Elle peut utiliser les constantes et les énumérations de la classe externe (MAX_STACK ci-dessus), mais pas ses variables membres : Slot n’a pas accès à slots, car un emplacement est un objet distinct. Transmets-lui toute valeur dont elle a besoin dans son constructeur.

Utilise une classe interne pour un petit type qui n’a de sens qu’avec sa classe externe, comme un emplacement d’inventaire ou une entrée de tableau des scores. Un type utilisé seul par d’autres parties du jeu mérite son propre fichier et class_name.