參考資料 › 函式參考 › 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

返回函式參考