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: nilSaat 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 adaPerhatikan 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: 100player tidak pernah memiliki kunci sendiri, jadi setiap penetapan melewati __newindex, dan setiap pembacaan diteruskan ke data melalui __index.
Tantangan
MudahTulis 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
__newindexyang menerima tabel, key, dan value - Di dalam
__newindex, periksa apakah nilainya berupa string menggunakantype(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 tabelvalue(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
Pelajaran ini berisi kuis singkat. Mulai pelajarannya untuk menjawab kuis dan melacak progresmu.
Semua pelajaran di Logika dan Alur
1Iterasi Tabel Tingkat Lanjut
Iterasi dengan pairs()Iterasi dengan ipairs()pairs() vs. ipairs()Rangkuman: Lembar Karakter4Pengenalan Metatable
Apa Itu Metatable?setmetatable & getmetatableMetamethod __indexMetamethod __newindexMetamethod __tostringMetamethod Aritmetika Bagian 1Metamethod Aritmetika Bagian 2Ulasan: Tabel Hanya-Baca2Fungsi library tabel Lainnya
table.concat()Pembuatan tabel & unpack()table.sort()Pengurutan Kustom dengan FungsiRangkuman, Papan Skor TertinggiLatihan sendiri: Compiler Lua online