模組:TableTools/doc

本模块包含一系列用于处理Lua表的函数。这是个元模块，用于其他Lua模块调用，而不应该由#invoke直接调用。

加载模块

如需加载任何函数，首先需要加载模块。

local TableTools = require('Module:TableTools')

isPositiveInteger

TableTools.isPositiveInteger(value)

如果value是正整数，返回true，否则返回false。虽然此函数不是应用于表的，但这里仍收录了此函数以决定一个给定的键是否在表的数组部分或哈希部分。

isNan

TableTools.isNan(value)

如果value是NaN值，返回true，否则返回false。虽然此函数不是应用于表的，但这里仍收录了此函数以决定一个值能否作为有效的键。（将NaN作为键会报错。）

shallowClone

TableTools.shallowClone(t)

返回表格的副本。返回的值是一个新表，但是所有的子表和函数都会共用。不会绕过元表，但返回的表自身不会带有元表。如需在创建新表时不共享子表格且要复制元表，可以使用mw.clone。

removeDuplicates

TableTools.removeDuplicates(t)

从数组中返回重复值。此函数仅用于标准的数组，所有非正整数键的一律忽略，第一个nil后的值也会忽略。（对于包含nil的数组，可以先使用compressSparseArray。）此函数尝试保护数组的顺序：有重复值时，仅保留最早出现的那个。例如，对于表{5, 4, 4, 3, 4, 2, 2, 1}，removeDuplicates返回{5, 4, 3, 2, 1}。

numKeys

TableTools.numKeys(t)

接收表t并以数字顺序返回拥有非nil值的正整数键的数量。例如，对于{'foo', nil, 'bar', 'baz', a = 'b'}，numKeys返回{1, 3, 4}。

affixNums

TableTools.affixNums(t, prefix, suffix)

接收表t并返回包含含有可选前缀prefix和可选后缀suffix的键的数量的数组。例如，对于表{a1 = 'foo', a3 = 'bar', a6 = 'baz'}和前缀'a'，affixNums返回{1, 3, 6}。prefix和suffix的值均按字面解释（不使用正则表达式）。

numData

TableTools.numData(t, compress)

假如一个表有像foo1、bar1、foo2、baz2这样的键，返回如下格式的子表的表{ [1] = {foo = 'text', bar = 'text'}, [2] = {foo = 'text', baz = 'text'} }。不以整数结尾的键存储在命名为other的子表中。compress选项会压缩表以便通过ipairs迭代。

compressSparseArray

TableTools.compressSparseArray(t)

接收一个带有一个或更多nil值的数组t，移除所有的nil值，不影响其他值的顺序，以便于安全地通过ipairs遍历。所有非正整数的键都会移除。例如，对于表{1, nil, foo = 'bar', 3, 2}，compressSparseArray返回{1, 3, 2}。

sparseIpairs

TableTools.sparseIpairs(t)

这是用于遍历稀疏数组t的迭代器函数。类似于ipairs，但会一直迭代直到最高的数字键，而ipairs遇到第一个nil就可能会终止。忽略所有的非正整数键。

sparseIpairs常用语通用的for循环。

for i, v in TableTools.sparseIpairs(t) do
   -- 代码
end

注意sparseIpairs会在实现时使用pairs。尽管一些键看上去被忽略，但实际上运行时也会遍历到。

size

TableTools.size(t)

寻找“键/值对”表的大小。例如，对于{foo = 'foo', bar = 'bar'}，size返回2。函数也可以用于数组，但是对于数组，使用#操作符更高效。注意，为了查找表的大小，函数会使用pairs函数以遍历所有的表键。