Assinaturas de Índice

Você conheceu tipos de mapa como {[string]: number} no capítulo de tabelas — uma index signature: qualquer chave string mapeia para um valor number. Eles se destacam quando as chaves não são conhecidas enquanto você escreve o código: contadores, configurações, caches, pontuações — qualquer coisa construída em tempo de execução.

type Counts = {[string]: number}

local counts: Counts = {}
counts["potion"] = 3   -- qualquer chave string é permitida
counts["sword"] = 1
counts["potion"] += 1  -- os valores são verificados como números

Dois fatos em tempo de execução são importantes ao trabalhar com mapas. Primeiro, ler uma chave que nunca foi definida retorna nil — o padrão clássico de contagem lida com isso usando or, transformando missing em 0:

counts[item] = (counts[item] or 0) + 1

Segundo, pairs() itera as chaves de um mapa em ordem não garantida — executar o mesmo programa duas vezes pode visitar as chaves de forma diferente. Sempre que a saída precisar ser previsível, colete as chaves em um array, ordene-as com table.sort e itere o array ordenado em seu lugar:

local keys: {string} = {}
for key in pairs(counts) do
    table.insert(keys, key)
end
table.sort(keys)
for _, key in ipairs(keys) do
    print(`{key}: {counts[key]}`)
end