Menu
CoddyTech
Começar a aprender

Enums de String como Unions

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

Números geram registros enigmáticos: ver 2 diz pouco, ver "down" diz tudo. Para enums legíveis, os tipos de união de literais do Luau são a ferramenta: um tipo cujos membros são strings exatas:

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

local facing: Direction = "up"    -- ✓
local typo: Direction = "upp"     -- ✗ erro de tipo durante a edição

Uma variável anotada com Direction pode conter essas quatro strings e nada mais. Escreva uma delas incorretamente e o verificador detecta o erro instantaneamente: o bug nunca chega a um jogador.

Em tempo de execução, os valores são strings simples. Imprima-os, concatene-os, compare-os usando ==. Tudo o que você sabe sobre strings se aplica:

print(facing)            -- cima
print(`facing {facing}`) -- facing cima

Compare os dois padrões que você tem agora: a tabela de constantes cria um valor em tempo de execução (UserRole) que contém membros, enquanto a união de literais não cria valor algum. Não existe uma tabela Direction, apenas uma regra que o verificador impõe sobre quais strings são válidas. Valores descritivos e autoexplicativos, sem custo em tempo de execução, fazem das uniões de literais o estilo de enum preferido no código Luau.

challenge icon

Desafio

Fácil

Armazene uma direção que só pode ser um de quatro nomes.

  1. Escreva type Direction = "up" | "down" | "left" | "right".
  2. Declare local facing: Direction = "left".
  3. Imprima facing, depois `The player moves {facing}`.

Pressione Executar código: a saída mostra left e The player moves left.

Experimente você mesmo

-- 1) defina o tipo Direction como uma união de quatro strings
-- 2) local facing: Direction = "left"
-- 3) imprima facing e, em seguida, a frase

Todas as lições de Introdução ao Luau

1Começando com o Luau

O que é Luau?Por que usar Luau?Seu primeiro código em LuauVerificação de tipos e modos de erroRecapitulando: Introdução ao Luau

4Trabalhando com funções

Tipagem de parâmetros e valores de retornoTipagem de funções anônimasFunções sem retornoParâmetros opcionaisValores padrão dos parâmetrosValores padrão para booleanosFunções variádicasDefinindo tipos de funçãoRecapitulação: funções tipadas

7Projeto: Gerenciador de Tarefas Tipado

Projeto: A Estrutura da TarefaFunção para Adicionar uma TarefaLição de projetoFunção para Alterar o Status da TarefaLição de projetoFunção: Listar Tarefas por StatusLição de projetoFunção: Exibir Resumo das TarefasLição de projetoLoop de Comandos: AdicionarLição de projetoLoop de Comandos: Listar e ConcluirLição de projetoLoop de Comandos: ResumoLição de projeto

10Projeto: Inventário Genérico

Projeto: Item do InventárioFunção: Adicionar ItensLição de projetoA Lista de ArmasLição de projetoFunção: Encontrar Item por IDLição de projetoTipos Específicos de InventárioLição de projetoFunção: Descrever ItensLição de projetoResponder a Consultas sobre ItensLição de projeto

2Tipos básicos

Número, string e booleanoO tipo 'any': válvula de escapeO tipo 'unknown'Tipos nulos e opcionaisInferência de tipos na práticaAnotações explícitas de tipoRevisão: prática com tipos básicos

5Aliases, Uniões, Interseções

Aliases de Tipos para PrimitivosTipos de UniãoTrabalhando com Tipos de UniãoTipos LiteraisTipos de InterseçãoCombinando Aliases de TiposRecapitulando: Combinações Avançadas de Tipos

8Enums, do Jeito Luau

O Padrão Enum no LuauEnums Numéricos com TablesEnums de String como UnionsUsando Enums de Union LiteralCongelando Tables ConstantesRecapitulação: Enums, do Jeito Luau

11Tópicos Avançados

Asserções de TipoProteções de Tipo com typeofO Tipo neverSegurança contra nil no Modo EstritoAssinaturas de ÍndiceRevisão: Tipos de Valores de ConfiguraçãoRevisão: Ajuste Fino de Tipos

3Tabelas Tipadas: Arrays e Maps

Arrays TipadosAdicionando e Lendo ElementosO que é um Tipo Map?Declarando e Acessando MapsPercorrendo TabelasTabelas com Formatos MistosLendo uma GradeConstruindo uma Gradetable.unpackRevisão: Arrays e Maps

6Tipando Formatos de Tabelas

Anotações de Formato InlineAliases de Tipo para FormatosPropriedades OpcionaisFormatos vs. Tabelas FlexíveisEstendendo FormatosAdicionando Métodos a FormatosSelf e Métodos com Dois PontosRecapitulação: Definindo Formatos de Tabelas

9Generics: Uma Primeira Visão

O Problema que Generics ResolvemUma Função de Identidade GenéricaUsando uma Função GenéricaArrays GenéricosAliases de Tipos GenéricosRecapitulação: Funções Genéricas

Pratique por conta própria: Compilador de Luau online