模組:TableTools/doc
这是Module:TableTools的文档页面
此模块文档被引用於約435,000個頁面。 為了避免造成大規模的影響,所有對此模块文档的編輯應先於沙盒或測試樣例上測試。 測試後無誤的版本可以一次性地加入此模块文档中,但是修改前請務必於討論頁發起討論。 模板引用數量會自動更新。 |
本模块已与en:Module:TableTools保持全域手动同步。 请注意,若您修改本地的模块,将可能影响同步。 |
本模块包含一系列用于处理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函数以遍历所有的表键。
keysToList
编辑TableTools.keysToList(t, keySort)
返回表的键的列表,并按默认比较函数或者自定义keySort
函数排序,与table.sort
的comp
函数类似。
sortedPairs
编辑TableTools.sortedPairs(t, keySort)
迭代表,并使用keysToList
函数来排序键。如果只有数字键,sparseIpairs
可能更高效。
isArray
编辑TableTools.isArray(t)
如果表中的所有键都是以1
开始的接连不断的整数,返回true。
listToSet
编辑TableTools.listToSet(arr)
从表arr
的数组部分创建一个集(set)。用arr
的任何值来索引集都会返回true
。
local set = TableTools.listToSet { "a", "b", "c" }
assert(set["a"] == true)
invert
编辑TableTools.invert(t)
交换数组中的键和值。例如,invert{ "a", "b", "c" }
产生{ a = 1, b = 2, c = 3 }
。
deepCopy
编辑TableTools.deepCopy(orig, noMetatable, alreadySeen)
返回表orig
的副本,类似于mw.clone
,所有非函数的值都会复制,并保留表的唯一性。如果noMetatable
为true
,则不会复制元表(如有)。可以复制由mw.loadData
加载的表。
与mw.clone
类似,但mw.clone
不能够复制由mw.loadData
加载的表,也不允许拒绝复制元表。
sparseConcat
编辑TableTools.sparseConcat(t, sep)
按顺序连接被正整数索引的表的所有值。
length
编辑TableTools.length(t)
查找数组的长度,或者带有像data1、data2这样的键的准数组。使用指数搜索算法以查找长度,以便于尽可能少地使用表查找(table lookup)。
对于准数组,此算法对使用元表的数组有用(例如frame.args)。对于正常数组,只需要使用#操作符,因为#操作符是由C语言实现的,速度更快。
inArray
编辑TableTools.inArray(arr, valueToFind)
如果valueToFind
是数组arr
的成员,返回true
,否则返回false
。