setmetatable (table, metatable)

Lua 中的每個值都可以用一個 metatable。 這個 metatable 就是一個原始的 Lua table ， 它用來定義原始值在特定操作下的行為。 你可以通過在 metatable 中的特定域設一些值來改變擁有這個 metatable 的值 的指定操作之行為。 舉例來說，當一個非數字的值作加法操作的時候， Lua 會檢查它的 metatable 中 "__add" 域中的是否有一個函數。 如果有這么一個函數的話，Lua 調用這個函數來執行一次加法。

我們叫 metatable 中的鍵名為 事件 (event) ，把其中的值叫作 元方法 (metamethod)。 在上個例子中，事件是 "add" 而元方法就是那個執行加法操作的函數。

你可以通過 getmetatable 函數來查詢到任何一個值的 metatable。

你可以通過 setmetatable 函數來替換掉 table 的 metatable 。 你不能從 Lua 中改變其它任何類型的值的 metatable （使用 debug 庫例外）； 要這樣做的話必須使用 C API 。

每個 table 和 userdata 擁有獨立的 metatable （當然多個 table 和 userdata 可以共享一個相同的表作它們的 metatable）； 其它所有類型的值，每種類型都分別共享唯一的一個 metatable。 因此，所有的數字一起只有一個 metatable ，所有的字符串也是，等等。

一個 metatable 可以控制一個對象做數學運算操作、比較操作、連接操作、取長度操作、取下標操作時的行為， metatable 中還可以定義一個函數，讓 userdata 作垃圾收集時調用它。 對于這些操作，Lua 都將其關聯上一個被稱作事件的指定健。 當 Lua 需要對一個值發起這些操作中的一個時， 它會去檢查值中 metatable 中是否有對應事件。 如果有的話，鍵名對應的值（元方法）將控制 Lua 怎樣做這個操作。
metatable 可以控制的操作已在下面列出來。 每個操作都用相應的名字區分。 每個操作的鍵名都是用操作名字加上兩個下劃線 '__' 前綴的字符串； 舉例來說，"add" 操作的鍵名就是字符串 "__add"。 這些操作的語義用一個 Lua 函數來描述解釋器如何執行更為恰當。

setmetatable

Sets the metatable for the given table. (You cannot change the metatable of other types from Lua, only from C.) If metatable is nil, removes the metatable of the given table. If the original metatable has a "__metatable" field, raises an error.
This function returns table.