Metamethod __newindex

Kamu telah mempelajari cara __index mengendalikan apa yang terjadi saat kamu mencoba membaca kunci yang tidak ada di dalam tabel. Sekarang kamu akan mempelajari pasangannya: __newindex, yang mengendalikan apa yang terjadi saat kamu mencoba menambahkan atau mengubah pasangan kunci-nilai.

Metamethod __newindex dipicu setiap kali kamu mencoba menetapkan nilai ke kunci yang belum ada di tabel. Ini memberimu kemampuan untuk mencegat dan mengendalikan perubahan sebelum terjadi.

Berikut contoh sederhana yang mencegah penambahan kunci baru ke tabel:

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

Saat kamu mencoba menetapkan readOnly.name = "Alice", Lua melihat bahwa name tidak ada di tabel. Alih-alih menambahkannya, Lua memanggil fungsi __newindex dengan tiga argumen: tabel itu sendiri, key yang sedang ditetapkan, dan nilai yang ditetapkan.

Dalam contoh ini, fungsi hanya mencetak pesan dan tidak benar-benar menyimpan apa pun.

Kamu juga bisa menggunakan __newindex untuk memvalidasi data sebelum mengizinkannya masuk ke tabelmu:

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     -- Diizinkan

Perhatikan penggunaan rawset() pada contoh kedua. Fungsi ini melewati metatable dan langsung menetapkan nilai di dalam tabel.

Tanpanya, mengatur nilai akan memicu __newindex lagi dan menciptakan perulangan tanpa akhir.