Lua table functions
Lua table functions These are the functions in the "table" table. Tables are collections of key/value pairs, where both the key and the value can be any Lua data type, except nil. Tables are indexed by the key, so if you know the key you can quickly retrieve the value. If you don't know the keys you can search the table using the "pairs" or "ipairs" functions. Since keys and values can be any data type (except nil) it follows that tables can contain other tables. A table's size (which is only relevant for numerically-indexed tables) is one less than the first integer index with a nil value. If the table has "holes" in it - that is, numeric keys with gaps in the sequence - then the table size is not guaranteed to be the the last gap. Lua does a binary search to try to find a gap, it does not necessarily find the first or last one. If you are planning to treat your tables as vectors (that is, with numeric keys and a size) then we recommend that you do not allow gaps in the sequence. If you want to know if a table is empty, or not, you can test:
    if next (t) == nil then
      -- table t is empty
    end -- if empty
The behaviour of tables can be modified somewhat by attaching a "metatable" to them with the setmetatable function. See Also ... Topics Lua base functions Lua bc (big number) functions Lua bit manipulation functions Lua coroutine functions Lua debug functions Lua io functions Lua math functions Lua os functions Lua package functions Lua PCRE regular expression functions Lua script extensions Lua string functions Lua utilities Scripting Lua functions table.concat (Concatenates table items together into a string) table.foreach (Applies a function to each item in a table) table.foreachi (Applies a function to each item in a numerically-keyed table) table.getn (Returns the size of a numerically-keyed table) table.insert (Inserts a new item into a numerically-keyed table) table.maxn (Returns the highest numeric key in the table) table.remove (Removes an item from a numerically-keyed table) table.setn (Sets the size of a table (obsolete)) table.sort (Sorts a table) (Help topic: general=lua_tables) Documentation contents page