Metamethods

Metamethods are special functions used by Lua to customize the behavior of values when they participate in operations. They live in metatables and are invoked automatically by the interpreter when a corresponding operation is performed on a value with an associated metatable. Metamethods enable features such as operator overloading, custom indexing, and configurable invocation semantics.

Common metamethods include add, sub, mul, div, mod, pow and unm for arithmetic; concat for string concatenation; len for the length operator; index and newindex for reading and writing fields; call for making a table callable; tostring for string representation; and eq, lt, le for comparisons. Lua also supports iteration-related metamethods such as pairs at times. When a value lacks an explicit metamethod, Lua uses the default semantics.

Implementation typically involves assigning a metatable to a value and defining the metamethods under their special keys. A metamethod is called if the corresponding operation is performed and the left-hand value provides a metatable with the matching key. Metamethods can implement customized behavior, create proxies, or enforce invariants, but they can complicate reasoning about code and may incur overhead. To bypass metamethods, rawget and rawset can be used.

While metamethods are a Lua feature, the idea of special methods that redefine operator and language-construct behavior appears in other languages under different names, such as magic or dunder methods in Python. Metamethods provide flexibility for extension and metaprogramming, but they require careful design to remain predictable and maintainable.