Assinaturas de Índice

Você conheceu tipos de mapa como {[string]: number} no capítulo sobre tabelas: uma assinatura de índice: qualquer chave de string mapeia para um valor numérico. Eles são úteis quando as chaves não são conhecidas enquanto você escreve o código: contadores, configurações, caches, pontuações: qualquer coisa criada 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 de 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 pelas chaves de um mapa em uma ordem não garantida: executar o mesmo programa duas vezes pode percorrer as chaves de maneiras diferentes. Sempre que a saída precisar ser previsível, reúna as chaves em um array, aplique table.sort a elas e itere pelo array ordenado:

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