Usare enum con unioni di valori letterali

Le unioni di valori letterali sono particolarmente utili come parametri di funzione. Assegna a un parametro il tipo dell’unione e il type checker garantisce che la funzione venga chiamata solo con un membro valido:

type Direction = "up" | "down" | "left" | "right"

local function move(direction: Direction)
    print(`Moving {direction}...`)
end

move("left")  -- ✓
move("north") -- ✗ errore di tipo: non è una Direction

All’interno della funzione, gestisci tutti i membri in modo esaustivo con una catena if/elseif. Poiché il tipo limita l’input a quattro valori, controllarne tre e lasciare che else gestisca l’ultimo copre tutti i casi:

local function describe(direction: Direction): string
    if direction == "up" then
        return "Going upward"
    elseif direction == "down" then
        return "Going downward"
    elseif direction == "left" then
        return "Turning left"
    else
        return "Turning right"
    end
end

Un dettaglio da tenere presente: le stringhe che arrivano dall’esterno, come io.read(), sono tipizzate come semplici string, perché il type checker non può sapere cosa digiterà l’utente. Il cast :: che hai imparato prima gli dice di trattare il valore come il tuo tipo enum:

local direction = io.read() :: Direction

Un cast è una promessa, non un controllo: in fase di esecuzione non viene verificato nulla sull’input. Nel codice di produzione, prima si convaliderebbe l’input; qui, invece, permette alle funzioni tipizzate di accettare facilmente l’input dell’utente.