Сигнатуры индексов

В главе о таблицах ты уже встречал типы map, например {[string]: number}: сигнатура индекса означает, что любой строковый ключ соответствует числовому значению. Они особенно удобны, когда ключи неизвестны во время написания кода: счётчики, настройки, кэши, очки — всё, что формируется во время выполнения.

type Counts = {[string]: number}

local counts: Counts = {}
counts["potion"] = 3   -- допускается любой строковый ключ
counts["sword"] = 1
counts["potion"] += 1  -- значения проверяются как числа

При работе с map важны два факта о времени выполнения. Во-первых, чтение ключа, которому никогда не присваивали значение, возвращает nil: классический шаблон подсчёта обрабатывает это с помощью or, заменяя «отсутствующее» значение на 0:

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

Во-вторых, pairs() перебирает ключи map в неопределённом порядке: при двух запусках одной и той же программы ключи могут посещаться в разном порядке. Если результат должен быть предсказуемым, собери ключи в массив, отсортируй их с помощью table.sort и перебирай отсортированный массив:

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