מטא־מתודת __newindex

למדת כיצד __index שולט במה שקורה כשמנסים לקרוא מפתח שאינו קיים בטבלה. עכשיו תגלה את המקבילה שלו: __newindex, ששולט במה שקורה כשמנסים להוסיף או לשנות זוג מפתח-ערך.

מתודת המטא __newindex מופעלת בכל פעם שמנסים להקצות ערך למפתח שאינו קיים כרגע בטבלה. כך אפשר ליירט שינויים ולשלוט בהם לפני שהם מתבצעים.

הנה דוגמה פשוטה שמונעת הוספה של מפתחות חדשים לטבלה:

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

setmetatable(readOnly, meta)

readOnly.name = "Alice"  -- פלט: Cannot add key: name
print(readOnly.name)     -- פלט: nil

כשאתה מנסה להגדיר את readOnly.name = "Alice", Lua רואה שהמפתח name לא קיים בטבלה. במקום להוסיף אותו, Lua קוראת לפונקציה __newindex עם שלושה ארגומנטים: הטבלה עצמה, המפתח שמוגדר והערך שמוקצה.

בדוגמה הזאת, הפונקציה פשוט מדפיסה הודעה ולא באמת שומרת שום דבר.

אפשר גם להשתמש ב־__newindex כדי לאמת נתונים לפני שמאפשרים להכניס אותם לטבלה שלך:

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"  -- פלט: Health must be a number!
player.health = 100     -- מותר

שימו לב לשימוש ב־rawset() בדוגמה השנייה. הפונקציה הזו עוקפת את המטא־טבלה ומגדירה את הערך ישירות בטבלה.

בלעדיו, הגדרת הערך תפעיל שוב את __newindex, ותיצור לולאה אינסופית.