Assinaturas de Índice

Parte da seção Introdução ao Luau do Journey de Lua da Coddy. Lição 78 de 80.

Você conheceu tipos de mapa como {[string]: number} no capítulo sobre tabelas: uma assinatura de índice: qualquer chave do tipo string mapeia para um valor do tipo number. 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 durante a execução.

type Counts = {[string]: number}

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

Dois fatos sobre a 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 um valor "ausente" 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 visitar as chaves em ordens diferentes. Sempre que a saída precisar ser previsível, reúna as chaves em um array, ordene-as com table.sort 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

Desafio

Fácil

Mantenha as pontuações de jogadores cujos nomes você não conhece antecipadamente.

Escreva type Scores = {[string]: number} e crie local scores: Scores = {}.
Adicione pontos: scores["mia"] = (scores["mia"] or 0) + 5 e, em seguida, faça o mesmo para "leo" com 3.
Imprima scores["mia"], scores["leo"] e scores["zed"].

Pressione Executar código: a saída mostra 5, 3 e nil.

Experimente você mesmo

-- 1) type Scores = {[string]: number}, depois local scores: Scores = {}
-- 2) adicione 5 pontos para "mia" e 3 para "leo"
-- 3) imprima mia, leo e zed