Menu
CoddyTech

Metamethod __newindex

Termasuk bagian Logika dan Alur dalam perjalanan Lua di Coddy. Pelajaran 19 dari 54.

Kamu sudah mempelajari cara __index mengatur apa yang terjadi saat kamu mencoba membaca kunci yang tidak ada di dalam tabel. Sekarang kamu akan mempelajari pasangannya: __newindex, yang mengatur apa yang terjadi saat kamu menetapkan nilai ke kunci yang belum dimiliki tabel.

Metode metameta __newindex dipicu setiap kali kamu mencoba menetapkan nilai ke kunci yang saat ini tidak 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 mengatur readOnly.name = "Alice", Lua melihat bahwa name tidak ada di tabel. Alih-alih menambahkannya, Lua memanggil fungsi __newindex dengan tiga argumen: tabel itu sendiri, kunci yang sedang diatur, dan nilai yang diberikan.

Dalam contoh ini, fungsi hanya mencetak pesan dan sebenarnya tidak 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, disimpan dengan rawset
player.health = "high"  -- Tidak ada pesan: health sekarang sudah ada

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

Tanpanya, menetapkan nilai akan memicu __newindex lagi dan membuat perulangan tanpa akhir.

Karena __newindex hanya berjalan untuk kunci yang belum dimiliki tabel, pemeriksaan ini melindungi penetapan pertama setiap kunci. Setelah rawset menyimpan health, penetapan berikutnya mengubahnya secara langsung. Untuk memeriksa setiap penetapan, biarkan tabel itu sendiri kosong dan simpan nilainya di tabel kedua yang dibacanya melalui __index:

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

player.health = 100
player.health = "high"  -- output: Health must be a number!
print(player.health)    -- output: 100

player tidak pernah memiliki kunci sendiri, jadi setiap penetapan melewati __newindex, dan setiap pembacaan diteruskan ke data melalui __index.

challenge icon

Tantangan

Mudah

Tulis fungsi createValidatedTable yang menerima key dan value, lalu mengembalikan tabel yang hanya menerima nilai string untuk kunci baru.

Buat tabel kosong dan pasangkan metatable dengan __newindex yang memvalidasi tipe data nilai. Jika seseorang mencoba menambahkan nilai non-string, gunakan rawset() untuk menyimpan string "invalid" sebagai gantinya. Untuk nilai string, simpan secara normal menggunakan rawset().

Logika:

  • Buat tabel kosong
  • Buat metatable dengan __newindex yang menerima tabel, key, dan value
  • Di dalam __newindex, periksa apakah nilainya berupa string menggunakan type(value) == "string"
  • Jika nilainya berupa string, gunakan rawset(t, key, value) untuk menyimpannya
  • Jika nilainya bukan string, gunakan rawset(t, key, "invalid") untuk menyimpan "invalid" sebagai gantinya
  • Pasangkan metatable ke tabel menggunakan setmetatable()
  • Gunakan rawset() untuk menambahkan pasangan key-value awal ke tabel, tanpa melalui metatable
  • Kembalikan tabel

Parameter:

  • key (string): Key awal yang akan ditambahkan ke tabel
  • value (string): Nilai awal yang akan ditambahkan ke tabel

Nilai kembalian: Tabel dengan validasi yang hanya menerima nilai string dan berisi pasangan key-value awal (tabel)

Coba sendiri

function createValidatedTable(key, value)
    -- Tulis kodemu di sini
end
quiz iconUji dirimu

Pelajaran ini berisi kuis singkat. Mulai pelajarannya untuk menjawab kuis dan melacak progresmu.

Semua pelajaran di Logika dan Alur

Latihan sendiri: Compiler Lua online