diff options
Diffstat (limited to 'locale/en-us/meta.lua')
| -rw-r--r-- | locale/en-us/meta.lua | 13 |
1 files changed, 13 insertions, 0 deletions
diff --git a/locale/en-us/meta.lua b/locale/en-us/meta.lua index 8e4a2fb1..9ab6aab8 100644 --- a/locale/en-us/meta.lua +++ b/locale/en-us/meta.lua @@ -726,6 +726,19 @@ table.foreachi = 'Executes the given f over the numerical indices of table. For each index, f is called with the index and respective value as arguments. Indices are visited in sequential order, from 1 to n, where n is the size of the table. If f returns a non-nil value, then the loop is broken and this value is returned as the result of foreachi.' table.getn = 'Returns the number of elements in the table. This function is equivalent to `#list`.' +table.new = +[[This creates a pre-sized table, just like the C API equivalent `lua_createtable()`. This is useful for big tables if the final table size is known and automatic table resizing is too expensive. `narray` parameter specifies the number of array-like items, and `nhash` parameter specifies the number of hash-like items. The function needs to be required before use. +```lua + require("table.new") +``` +]] +table.clear = +[[This clears all keys and values from a table, but preserves the allocated array/hash sizes. This is useful when a table, which is linked from multiple places, needs to be cleared and/or when recycling a table for use by the same context. This avoids managing backlinks, saves an allocation and the overhead of incremental array/hash part growth. The function needs to be required before use. +```lua + require("table.clear"). +``` +Please note this function is meant for very specific situations. In most cases it's better to replace the (usually single) link with a new table and let the GC do its work. +]] utf8 = '' |