Introdução aos métodos virtuais

Python tem métodos mágicos, como __init__ e __str__, que a linguagem chama para você. A versão do Godot é o método virtual: um método com um nome fixo, que começa com um sublinhado, que você define na sua classe e que o Godot chama no momento certo. Você já usou dois:

• _init() é executado quando new() cria o objeto, com os argumentos fornecidos a new().
• _ready() é executado quando um nó entra na árvore de cena, que é onde main.gd começa.

Outros são _to_string(), chamado quando um objeto é impresso, os métodos iteradores que permitem que um loop for percorra um objeto (ambos nas próximas lições) e _notification(), que recebe eventos do mecanismo. Um deles, NOTIFICATION_PREDELETE, ocorre logo antes de o objeto ser excluído:

# torch.gd
class_name Torch
extends RefCounted

var label: String

func _init(new_label: String = "Torch") -> void:
	label = new_label
	print(label, " lit")

func _notification(what: int) -> void:
	if what == NOTIFICATION_PREDELETE:
		print(label, " burned out")

# main.gd
var torch := Torch.new("Hall torch") # Tocha do corredor acesa
torch = null # Tocha do corredor apagada

Um objeto RefCounted é excluído assim que nenhuma variável mais se refere a ele, então torch = null envia a notificação imediatamente. O valor padrão em _init() torna o argumento de new() opcional: Torch.new() cria uma tocha chamada Torch.

Python também usa métodos mágicos para operadores, como __add__ para + e __eq__ para ==. GDScript não tem sobrecarga de operadores: potion_a + potion_b é um erro. Escreva um método em vez disso:

# potion.gd
class_name Potion
extends RefCounted

var power: int

func _init(start_power: int) -> void:
	power = start_power

func combined(other: Potion) -> Potion:
	return Potion.new(power + other.power)

potion_a.combined(potion_b) retorna uma nova poção e deixa ambas as originais inalteradas. == entre dois objetos verifica se ambos os lados são o mesmo objeto, não se seus valores correspondem: Potion.new(5) == Potion.new(5) é false. Escreva um método como equals(other) quando precisar comparar valores.