Metoda _to_string

Wyświetlenie obiektu, którego klasa nie definiuje _to_string(), pokazuje tylko jego klasę i wewnętrzny identyfikator, który zmienia się przy każdym uruchomieniu: <RefCounted#-9223372009541466673>. Zdefiniuj _to_string() i zwróć tekst, który powinien pojawić się zamiast tego:

# card.gd
class_name Card
extends RefCounted

var rank: String
var suit: String

func _init(new_rank: String, new_suit: String) -> void:
	rank = new_rank
	suit = new_suit

func _to_string() -> String:
	return rank + " of " + suit

Godot wywołuje ją za każdym razem, gdy obiekt jest zamieniany na tekst: przez print(), przez str(), przez %s w ciągu formatującym oraz dla każdego obiektu wewnątrz wypisywanej tablicy lub słownika:

var card := Card.new("Queen", "hearts")
print(card) # Dama kier
print(str(card)) # Dama kier
print("You drew %s" % card) # Dobrałeś damę kier
print([card, Card.new("7", "clubs")]) # [Dama kier, 7 trefl]

"You drew " + card nadal powoduje błąd, ponieważ + łączy dwa ciągi znaków, a card jest obiektem. Najpierw przekonwertuj go: "You drew " + str(card).

Podklasa może przesłonić _to_string() i użyć tekstu klasy nadrzędnej za pomocą super():

# wild_card.gd
class_name WildCard
extends Card

func _to_string() -> String:
	return "Wild " + super()

print(WildCard.new("King", "spades")) wyświetla Wild King of spades.

_to_string() zwraca tekst i sam niczego nie wyświetla. Kod korzystający z obiektu decyduje, czy tekst zostanie wyświetlony, połączony w dłuższy wiersz czy zapisany.