table.create

Author: sumneko

locale/en-us/meta.lua

@@ -712,6 +712,8 @@ table                       =
 ''
 table.concat                =
 'Given a list where all elements are strings or numbers, returns the string `list[i]..sep..list[i+1] ··· sep..list[j]`.'
+table.create                =
+'Creates a new empty table, preallocating memory. This preallocation may help performance and save memory when you know in advance how many elements the table will have. Parameter `nseq` is a hint for how many elements the table will have as a sequence. Optional parameter `nrec` is a hint for how many other elements the table will have; its default is zero.'
 table.insert                =
 'Inserts element `value` at position `pos` in `list`.'
 table.maxn                  =

locale/es-419/meta.lua

@@ -693,6 +693,8 @@ table                       =
 ''
 table.concat                =
 'Dada una lista donde todos los elementos son strings o números, retorna el string `list[i]..sep..list[i+1] ··· sep..list[j]`.'
+table.create                =
+'Crea una nueva tabla vacía, preasignando memoria. Esta preasignación puede ayudar al rendimiento y ahorrar memoria cuando conoces de antemano cuántos elementos tendrá la tabla. El parámetro `nseq` es una pista de cuántos elementos tendrá la tabla como secuencia. El parámetro opcional `nrec` es una pista de cuántos otros elementos tendrá la tabla; su valor predeterminado es cero.'
 table.insert                =
 'Inserta el elemento `value` en la posición `pos` en la lista `list`.'
 table.maxn                  =

locale/ja-jp/meta.lua

@@ -686,6 +686,8 @@ table                       =
 ''
 table.concat                =
 'すべての要素が文字列または数値であるリストに対して、`list[i]..sep..list[i+1] ··· sep..list[j]` という文字列を返す。'
+table.create                =
+'新しい空のテーブルを作成し、メモリを事前に割り当てます。テーブルに含まれる要素数を事前に知っている場合、この事前割り当てによりパフォーマンスの向上とメモリの節約が期待できます。パラメータ `nseq` はテーブルがシーケンスとして持つ要素数のヒントです。オプションのパラメータ `nrec` はテーブルが持つその他の要素数のヒントで、デフォルトは0です。'
 table.insert                =
 '要素 `value` を `list` の位置 `pos` に挿入する。'
 table.maxn                  =

locale/pt-br/meta.lua

@@ -693,6 +693,8 @@ table                       =
 ''
 table.concat                =
 'Dada uma lista onde todos os elementos são strings ou números, retorna a string `list[i]..sep..list[i+1] ··· sep..list[j]`.'
+table.create                =
+'Cria uma nova tabela vazia, pré-alocando memória. Esta pré-alocação pode ajudar no desempenho e economizar memória quando você souber com antecedência quantos elementos a tabela terá. O parâmetro `nseq` é uma dica para quantos elementos a tabela terá como sequência. O parâmetro opcional `nrec` é uma dica para quantos outros elementos a tabela terá; seu padrão é zero.'
 table.insert                =
 'Insere o elemento `value` na posição `pos` de `list`.'
 table.maxn                  =

locale/zh-cn/meta.lua

@@ -671,6 +671,8 @@ table                       =
 ''
 table.concat                =
 '提供一个列表，其所有元素都是字符串或数字，返回字符串 `list[i]..sep..list[i+1] ··· sep..list[j]`。'
+table.create                =
+'创建一个新的空表，预分配内存。当您预先知道表将有多少元素时，这种预分配可能有助于性能和节省内存。参数 `nseq` 是表作为序列将有多少元素的提示。可选参数 `nrec` 是表将有多少其他元素的提示；默认值为零。'
 table.insert                =
 '在 `list` 的位置 `pos` 处插入元素 `value`。'
 table.maxn                  =

locale/zh-tw/meta.lua

@@ -676,6 +676,8 @@ table                       =
 ''
 table.concat                =
 '提供一個列表，其所有元素都是字串或數字，回傳字串 `list[i]..sep..list[i+1] ··· sep..list[j]`。'
+table.create                =
+'建立一個新的空表，預先配置記憶體。當您預先知道表將有多少元素時，這種預先配置可能有助於效能和節省記憶體。參數 `nseq` 是表作為序列將有多少元素的提示。可選參數 `nrec` 是表將有多少其他元素的提示；預設值為零。'
 table.insert                =
 '在 `list` 的位置 `pos` 處插入元素 `value`。'
 table.maxn                  =

meta/template/table.lua

@@ -13,6 +13,14 @@ table = {}
 ---@nodiscard
 function table.concat(list, sep, i, j) end
 
+---@version >5.5
+---#DES 'table.create'
+---@param nseq integer
+---@param nrec? integer
+---@return table
+---@nodiscard
+function table.create(nseq, nrec) end
+
 ---#DES 'table.insert'
 ---@overload fun(list: table, value: any)
 ---@param list table