Il metametodo __newindex

Hai imparato come __index controlla cosa succede quando provi a leggere una chiave che non esiste in una tabella. Ora scoprirai la sua controparte: __newindex, che controlla cosa succede quando provi ad aggiungere o modificare una coppia chiave-valore.

Il metametodo __newindex viene attivato ogni volta che provi ad assegnare un valore a una chiave che al momento non esiste nella tabella. Questo ti permette di intercettare e controllare le modifiche prima che avvengano.

Ecco un semplice esempio che impedisce di aggiungere nuove chiavi a una tabella:

local readOnly = {}
local meta = {
    __newindex = function(table, key, value)
        print("Cannot add key: " .. key)
    end
}

setmetatable(readOnly, meta)

readOnly.name = "Alice"  -- Output: Cannot add key: name
print(readOnly.name)     -- Output: nil

Quando provi a impostare readOnly.name = "Alice", Lua vede che name non esiste nella tabella. Invece di aggiungerlo, Lua chiama la funzione __newindex con tre argomenti: la tabella stessa, la chiave da impostare e il valore assegnato.

In questo esempio, la funzione si limita a stampare un messaggio e in realtà non memorizza nulla.

Puoi anche usare __newindex per convalidare i dati prima di consentirne l'inserimento nella tua tabella:

local player = {}
local meta = {
    __newindex = function(t, key, value)
        if key == "health" and type(value) ~= "number" then
            print("Health must be a number!")
        else
            rawset(t, key, value)
        end
    end
}

setmetatable(player, meta)

player.health = "high"  -- Output: Health must be a number!
player.health = 100     -- Consentito

Nota l’uso di rawset() nel secondo esempio. Questa funzione ignora la metatabella e imposta direttamente il valore nella tabella.

Senza di esso, impostare il valore attiverebbe di nuovo __newindex, creando un ciclo infinito.