Referência › Referência de funções › Functions

Functions.collections.multiinsert

pública

Chame como

Functions.collections.multiinsert(t, values)

Registre-a como uma dependência chamada Functions.collections.multiinsert (aceitar o preenchimento automático faz isso) e depois chame-a por esse nome.

O que faz

Insere cada valor percorrido por ipairs no índice inicial correspondente do array de destino. As entradas existentes são deslocadas após o prefixo inserido; o percurso para no primeiro índice de origem ausente.

Argumentos

NomeTipoO que faz
ttableArray de destino modificado no próprio lugar.
valuestableArray de origem cujo prefixo de ipairs é inserido sem copiar valores aninhados.

Retornos

1...Sem valores de retorno. O array de destino é modificado no próprio lugar.

Edições

As funções auxiliares integradas são registradas em todas as edições. O que muda é a API do jogo que elas leem; quando uma está ausente, a função auxiliar recorre a uma alternativa ou retorna nil com um motivo.

Não lê nenhuma API do jogo diretamente.

Exemplo

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

Código-fonte

Functions/collections.lua, linha 99. Somente leitura no jogo; Duplicar cria uma cópia editável.

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

Voltar para Referência de funções