Membri pubblici e privati

L'incapsulamento significa che un oggetto mantiene i propri dati insieme ai metodi che li modificano e decide quali dei suoi membri possono essere usati da altro codice. I membri destinati a essere usati da altro codice costituiscono l'interfaccia dell'oggetto.

GDScript non ha parole chiave public o private: ogni membro può essere raggiunto dall'esterno. La guida di stile di Godot contrassegna quelli privati con un trattino basso iniziale:

# bank_account.gd
class_name BankAccount
extends RefCounted

var owner_name: String
var _balance: int = 0
var _history: Array[String] = []

func _init(holder: String) -> void:
	owner_name = holder

func deposit(amount: int) -> void:
	_balance += amount
	_record("deposit %d" % amount)

func get_balance() -> int:
	return _balance

func _record(entry: String) -> void:
	_history.append(entry)

owner_name, deposit() e get_balance() sono pubblici, quindi main.gd li usa. _balance, _history e _record() sono privati: li usa solo il codice all'interno di bank_account.gd.

# main.gd
var account := BankAccount.new("Ada")
account.deposit(50)
account.deposit(20)
print(account.owner_name) # Ada
print(account.get_balance()) # 70

Il trattino basso è una convenzione, non un blocco: account._balance = 1000000 in main.gd viene eseguito senza errori. Rispetta comunque la convenzione. Se solo la classe modifica _balance, un saldo errato può provenire solo da un metodo in bank_account.gd, quindi è l’unico file che devi controllare.

Anche GDScript non ha un livello protected. Una sottoclasse eredita tutti i membri, inclusi quelli privati, quindi una SavingsAccount che extends BankAccount può usare _balance nei propri metodi.

Anche i metodi virtuali di Godot, come _init() e _ready(), iniziano con un trattino basso. Godot li chiama per te, quindi non dare mai lo stesso nome a uno dei tuoi metodi privati.