Metatable

Functions for manipulating metatables and controlling table read-only status. These bypass the __metatable metamethod.

getrawmetatable

Returns the metatable of an object, bypassing the __metatable metamethod.

getrawmetatable(object: any) -> table?

Parameter	Type	Description
object	any	The object to get the metatable of

Example

local mt = getrawmetatable(game)
print(mt) --> table

setrawmetatable

Sets the metatable of an object, bypassing the __metatable metamethod.

setrawmetatable(object: any, metatable: table?) -> void

Parameter	Type	Description
object	any	The object to set the metatable on
metatable	table?	The new metatable, or nil to remove

Example

local t = {}
setrawmetatable(t, {
    __index = function(_, key)
        return key .. " not found"
    end
})
print(t.hello) --> "hello not found"

setreadonly

Sets or clears the read-only flag on a table.

setreadonly(table: table, readonly: boolean) -> void

Parameter	Type	Description
table	table	The table to modify
readonly	boolean	true to make read-only, false to make writable

Example

local mt = getrawmetatable(game)
setreadonly(mt, false)
-- Now you can modify mt
mt.__namecall = newcclosure(function(...)
    return mt.__namecall(...)
end)
setreadonly(mt, true)

isreadonly

Returns true if the table is read-only.

isreadonly(table: table) -> boolean

Example

local mt = getrawmetatable(game)
print(isreadonly(mt)) --> true

makereadonly

Makes a table read-only. Equivalent to setreadonly(table, true).

Aliases: make_readonly

makereadonly(table: table) -> void

Example

local t = { key = "value" }
makereadonly(t)
print(isreadonly(t)) --> true

makewriteable

Makes a table writable. Equivalent to setreadonly(table, false).

Aliases: make_writeable

makewriteable(table: table) -> void

Example

local mt = getrawmetatable(game)
makewriteable(mt)
-- mt is now writable
makereadonly(mt)