Variáveis

Uma variável é um nome que contém um valor. Os valores das variáveis podem ser números, strings, booleanos, tipos de dados e mais.

Nomes de variáveis

Os nomes das variáveis podem ser qualquer string não reservada de letras, dígitos e sublinhados que não começam com um dígito.

LETRAS   -- válido
a1       -- válido
var_name -- válido
_test    -- válido

se        -- NÃO válido
25th      -- NÃO válido

Os nomes das variáveis são sensíveis a maiúsculas e minúsculas, então TestVar e TESTVAR são nomes diferentes. Evite nomear variáveis com um sublinhado e todas as letras maiúsculas, como _VERSION, porque o Luau pode reservá-las para variáveis globais internas.

Melhores práticas

É uma boa prática escrever palavras totalmente. Abreviações geralmente facilitam a escrita de código, mas dificultam a leitura. Seguir práticas comuns de nomenclatura ao nomear suas variáveis pode ajudar você e outros a entender seu significado ou propósito:

• Use nomes em PascalCase para objetos que se assemelham a classes e enums.
• Use nomes em PascalCase para todas as APIs do Roblox. APIs em camelCase estão quase todas obsoletas.
• Use nomes em camelCase para variáveis locais, valores de membros e funções.
• Use nomes em LOUD_SNAKE_CASE para constantes locais (variáveis com valores que você não espera que mudem).
• Não capitalize acrônimos inteiros dentro dos nomes. Por exemplo, escreva aJsonVariable ou MakeHttpCall.

Nomes reservados

Luau reserva as seguintes palavras-chave, portanto você não pode usá-las para nomear variáveis ou funções:

• and
• for
• or
• break
• function
• repeat
• do
• if
• return
• else
• in
• then
• elseif
• local
• true
• end
• nil
• until
• false
• not
• while

Atribuir valores

Para criar uma variável e atribuir um valor a ela, use o operador =. Coloque a variável à esquerda do = e o valor à direita. Se você não colocar um valor, o valor será nil.

As variáveis podem ter escopos globais ou locais escopos. Elas têm escopo global por padrão, mas é quase sempre melhor criá-las com escopo local porque o Luau acessa variáveis locais mais rapidamente do que variáveis globais. Para dar a uma variável escopo local, coloque a palavra-chave local antes do nome da variável ao atribuir um valor a ela. Para mais informações sobre Escopo no Luau, veja Escopo.

local nilVar
local x = 10
local word = "Olá"
local boolean = true

print(nilVar) -- nil
print(x) -- 10
print(word) -- Olá
print(boolean) -- true

Atribuir valores a várias variáveis

Você pode atribuir valores a várias variáveis em uma linha separando cada par variável-valor com uma vírgula. Se você tiver mais variáveis do que valores, o Luau atribui nil às variáveis extras. Se você tiver mais valores do que variáveis, o Luau não atribui os valores extras a nenhuma variável.

local a, b, c = 1, 2, 3
local d, e, f = 4, 5 -- variável extra
local g, h = 7, 8, 9 -- valor extra

print(a, b, c) -- 1, 2, 3
print(d, e, f) -- 4, 5, nil
print(g, h) -- 7, 8

Mudar valores

Para mudar o valor de uma variável, atribua outro valor a ela.

local x, y = 10, 20
print(x) -- 10
print(y) -- 20

local x = 1000
local y = 2000
print(x) -- 1000
print(y) -- 2000