Metametoda __newindex

Dowiedziałeś się, jak __index kontroluje to, co się dzieje, gdy próbujesz odczytać klucz, który nie istnieje w tabeli. Teraz poznasz jego odpowiednik: __newindex, który kontroluje to, co się dzieje, gdy próbujesz dodać lub zmodyfikować parę klucz-wartość.

Metametoda __newindex jest wywoływana za każdym razem, gdy próbujesz przypisać wartość do klucza, który obecnie nie istnieje w tabeli. Dzięki temu możesz przechwytywać i kontrolować modyfikacje, zanim nastąpią.

Oto prosty przykład, który uniemożliwia dodawanie nowych kluczy do tabeli:

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

setmetatable(readOnly, meta)

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

Gdy próbujesz ustawić readOnly.name = "Alice", Lua widzi, że w tabeli nie ma elementu name. Zamiast go dodać, Lua wywołuje funkcję __newindex z trzema argumentami: samą tabelą, ustawianym kluczem i przypisywaną wartością.

W tym przykładzie funkcja po prostu wyświetla komunikat i tak naprawdę niczego nie przechowuje.

Możesz również użyć __newindex, aby sprawdzać dane przed zezwoleniem na ich dodanie do tabeli:

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"  -- Wynik: Health must be a number!
player.health = 100     -- Dozwolone

Zwróć uwagę na użycie rawset() w drugim przykładzie. Ta funkcja omija metatabelę i bezpośrednio ustawia wartość w tablicy.

Bez tego ustawienie wartości ponownie wywołałoby __newindex, tworząc nieskończoną pętlę.