参考 › 函数参考 › Functions

Functions.collections.multiinsert

公共

调用方式

Functions.collections.multiinsert(t, values)

将其记录为名为 Functions.collections.multiinsert 的依赖项(接受自动补全即可完成),然后按该名称调用。

作用

将 ipairs 遍历到的每个值插入到目标数组中对应的开头索引处。现有条目会移到插入的前缀之后;遍历在第一个缺失的源索引处停止。

参数

名称类型作用
ttable被原地修改的目标数组。
valuestable源数组,其 ipairs 前缀会被插入,嵌套的值不会被复制。

返回值

1...没有返回值。目标数组会被原地修改。

版本

内置辅助函数在每个版本上都会注册。不同的是它们读取的游戏 API;某个 API 缺失时,辅助函数会改用后备方案,或返回 nil 并附上原因。

它不直接读取任何游戏 API。

示例

local order = { "Rend", "Overpower" }
Functions.collections.multiinsert(order, { "Execute", "Mortal Strike" })
-- order is now Execute, Mortal Strike, Rend, Overpower
return order[1] == "Execute"

源码

Functions/collections.lua,第 99 行。在游戏中为只读;“复制”会生成一份可编辑的副本。

Functions.collections.multiinsert(t, values)
    for i,v in ipairs(values) do
	    table.insert(t, i, v)
    end

返回函数参考