Phương thức _to_string

In ra một đối tượng có lớp không định nghĩa _to_string() chỉ hiển thị lớp và một ID nội bộ, thay đổi sau mỗi lần chạy: <RefCounted#-9223372009541466673>. Hãy định nghĩa _to_string() và trả về văn bản cần hiển thị thay thế:

# 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 gọi phương thức này mỗi khi biến đối tượng thành văn bản: khi dùng print(), str(), %s trong chuỗi định dạng và với từng đối tượng bên trong một Array hoặc Dictionary được in ra:

var card := Card.new("Queen", "hearts")
print(card) # Đầm cơ
print(str(card)) # Đầm cơ
print("You drew %s" % card) # Bạn rút được quân đầm cơ
print([card, Card.new("7", "clubs")]) # [Đầm cơ, 7 chuồn]

"You drew " + card vẫn gây lỗi, vì + nối hai chuỗi (string) còn card là một đối tượng. Hãy chuyển đổi nó trước: "You drew " + str(card).

Lớp con có thể ghi đè _to_string() và dùng văn bản của lớp cha với super():

# wild_card.gd
class_name WildCard
extends Card

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

print(WildCard.new("King", "spades")) in ra Wild King of spades.

_to_string() trả về văn bản và bản thân nó không in ra gì cả. Code sử dụng đối tượng sẽ quyết định văn bản được in ra, nối vào một dòng dài hơn hay lưu lại.