Wzorzec enumów w Luau

Programy są pełne wartości pochodzących z niewielkiego, ustalonego zbioru: zamówienie ma status oczekujące, wysłane lub dostarczone; gracz jest skierowany w górę, w dół, w lewo lub w prawo. Wiele języków ma do tego słowo kluczowe enum. Luau go nie ma i nie jest ono potrzebne, ponieważ tę rolę spełniają dwa narzędzia, które już znasz.

Wzorzec 1: tablica stałych. Zwykła tablica przypisuje znaczącym nazwom wartości, zastępując „magiczne liczby” porozrzucane w kodzie:

local Status = {
    Pending = 1,
    Active = 2,
    Done = 3,
}

print(Status.Active) -- 2

To rzeczywista wartość w czasie działania programu: możesz odczytać Status.Active, porównać z nią inną wartość i przekazywać ją dalej — tak jak tablice, których używasz od samego początku.

Wzorzec 2: unia literałów. Typ złożony z dokładnych wartości tekstowych, wykorzystujący typy literałowe poznane w rozdziale o uniach:

type Color = "red" | "green" | "blue"
local favorite: Color = "green" -- ✓
local oops: Color = "yellow"    -- ✗ błąd typu

Unia istnieje tylko na potrzeby mechanizmu sprawdzającego typy i nie powoduje żadnych kosztów w czasie działania programu, ale gwarantuje, że zmienna nie może przechowywać wartości spoza zbioru. Te dwa wzorce się uzupełniają: tablica udostępnia wartości w czasie działania programu pod jedną nazwą, a unia daje gwarancję na etapie kompilacji. W dalszej części tego rozdziału poznasz też table.freeze, które chroni tablicę stałych przed modyfikacją w czasie działania programu.