Sygnatury indeksów

Typy map, takie jak {[string]: number}, poznaliśmy już w rozdziale o tabelach: to sygnatura indeksu: dowolny klucz tekstowy wskazuje wartość liczbową. Sprawdzają się świetnie, gdy podczas pisania kodu nie znasz jeszcze kluczy: liczniki, ustawienia, pamięci podręczne, wyniki — wszystko, co jest gromadzone w czasie działania programu.

type Counts = {[string]: number}

local counts: Counts = {}
counts["potion"] = 3   -- dozwolony jest dowolny klucz typu string
counts["sword"] = 1
counts["potion"] += 1  -- wartości są sprawdzane jako liczby

Podczas pracy z mapami ważne są dwa fakty dotyczące działania programu. Po pierwsze, odczytanie klucza, któremu nigdy nie przypisano wartości, zwraca nil: klasyczny wzorzec zliczania obsługuje tę sytuację za pomocą or, zamieniając „brak” na 0:

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

Po drugie, pairs() iteruje po kluczach mapy w nieokreślonej kolejności: dwukrotne uruchomienie tego samego programu może odwiedzić klucze w różnej kolejności. Gdy wynik musi być przewidywalny, zbierz klucze w tablicy, posortuj je za pomocą table.sort i zamiast tego iteruj po posortowanej tablicy:

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