Functions.collections.index

Chame como

Functions.collections.index(array, value)

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

O que faz

Retorna a primeira chave cujo valor é igual ao valor fornecido durante o percurso de pairs. Tabelas de entrada nil ou false e valores ausentes retornam nil. Várias chaves correspondentes não têm ordem de seleção garantida.

Argumentos

Nome	Tipo	O que faz
`array`	`table \| nil \| false`	Tabela em que buscar; nil ou false retornam nil.
`value`	`any`	Valor comparado com cada valor da tabela usando a igualdade do Lua.

Retornos

1	`any`	Chave correspondente, incluindo uma chave false, ou nil quando não há correspondência.

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 priority = { "Fire", "Frost", "Arcane" }
local slot = Functions.collections.index(priority, "Frost")
return slot ~= nil and slot <= 2

Código-fonte

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

Functions.collections.index(array, value)

    if not array then return nil end

    for idx,v in pairs(array) do
        if (v == value) then
            return idx
        end
    end

Voltar para Referência de funções