Membres publics et privés

L’encapsulation signifie qu’un objet regroupe ses données et les méthodes qui les modifient, et décide quels membres de l’objet les autres codes peuvent utiliser. Les membres destinés aux autres codes constituent l’interface de l’objet.

GDScript n’a pas de mot-clé public ou private : chaque membre est accessible de l’extérieur. Le guide de style de Godot marque les membres privés avec un trait de soulignement initial :

# 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() et get_balance() sont publics, donc main.gd les utilise. _balance, _history et _record() sont privés : seul le code à l’intérieur de bank_account.gd les utilise.

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

Le trait de soulignement est une convention, pas un verrou : account._balance = 1000000 dans main.gd s’exécute sans aucune erreur. Respecte quand même la convention. Si seule la classe modifie _balance, un solde erroné ne peut provenir que d’une méthode dans bank_account.gd ; c’est donc le seul fichier que tu dois vérifier.

GDScript n’a pas non plus de niveau protected. Une sous-classe hérite de tous les membres, y compris les membres privés. Ainsi, une SavingsAccount qui extends BankAccount peut utiliser _balance dans ses propres méthodes.

Les méthodes virtuelles de Godot, telles que _init() et _ready(), commencent également par un trait de soulignement. Godot les appelle pour toi, alors ne donne jamais le même nom à l’une de tes méthodes privées.