La metaméthode __index

Maintenant que tu sais comment attacher des métatables aux tables, il est temps de découvrir le métaméthode le plus important : __index. Ce métaméthode contrôle ce qui se passe lorsque tu essaies d’accéder à une clé qui n’existe pas dans une table.

Normalement, lorsque tu recherches une clé qui ne se trouve pas dans une table, Lua renvoie nil. Mais lorsqu’une table possède une métatable avec un champ __index, Lua vérifiera plutôt ce champ. Si __index pointe vers une autre table, Lua y cherchera la clé :

local defaults = {
    health = 100,
    speed = 10
}

local player = {name = "Alice"}
local meta = {__index = defaults}

setmetatable(player, meta)

print(player.name)    -- Sortie : Alice
print(player.health)  -- Sortie : 100

Dans cet exemple, player ne possède qu’une clé name. Lorsque tu accèdes à player.health, Lua ne la trouve pas dans player, alors il vérifie le champ __index de la métatable. Comme __index pointe vers la table defaults, Lua y cherche et trouve health = 100.

Cela crée un mécanisme de repli où une table peut fournir des valeurs par défaut à une autre. La table d’origine conserve ses propres valeurs, mais toutes les clés manquantes sont automatiquement recherchées dans la table de repli.

__index peut aussi être une fonction. Lorsqu’une clé est absente, Lua l’appelle en lui transmettant la table et la clé, puis utilise la valeur qu’elle renvoie :

local scores = {alice = 12}

setmetatable(scores, {
    __index = function(t, key)
        return 0  -- chaque nom absent compte pour 0
    end
})

print(scores.alice)  -- Sortie : 12
print(scores.bob)    -- Sortie : 0

Une table fournit des valeurs de remplacement fixes ; une fonction peut calculer une valeur pour toute clé absente.