Variables | Documentation - Hub Création Roblox

Une variable est un nom qui contient une valeur. Les valeurs des variables peuvent être des nombres, des chaînes, des booléens, des types de données, et plus encore.

Nommer des variables

Les noms de variables peuvent être n'importe quelle chaîne de lettres, de chiffres et de traits de soulignement non réservés qui ne commencent pas par un chiffre.


LETTERS   -- valide
a1        -- valide
var_name  -- valide
_test     -- valide

if        -- NON valide
25th      -- NON valide

Les noms de variables sont sensibles à la casse, donc TestVar et TESTVAR sont des noms différents. Évitez de nommer les variables avec un trait de soulignement et toutes les lettres en majuscules, comme _VERSION, car Luau pourrait les réserver pour des variables globales internes.

Meilleures pratiques

Il est préférable d'épeler les mots complètement. Les abréviations rendent généralement le code plus facile à écrire, mais plus difficile à lire. Suivre des pratiques de nommage courantes lorsque vous nommez vos variables peut vous aider, vous et les autres, à comprendre leur signification ou leur objectif :

Utilisez des noms en PascalCase pour les classes et les objets de type énumération.
Utilisez des noms en PascalCase pour toutes les API Roblox. Les API en camelCase sont principalement obsolètes.
Utilisez des noms en camelCase pour les variables locales, les valeurs des membres et les fonctions.
Utilisez des noms en LOUD_SNAKE_CASE pour les constantes locales (variables avec des valeurs que vous ne vous attendez pas à changer).
Ne capitalisez pas les acronymes complets dans les noms. Par exemple, écrivez aJsonVariable ou MakeHttpCall.

Noms réservés

Luau réserve les mots-clés suivants, donc vous ne pouvez pas les utiliser pour nommer des variables ou des fonctions :

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

Assigner des valeurs

Pour créer une variable et lui attribuer une valeur, utilisez l'opérateur =. Mettez la variable à gauche du = et la valeur à droite. Si vous ne mettez pas de valeur, la valeur est nil.

Les variables peuvent avoir des portées globales ou locales. Elles ont une portée globale par défaut, mais il est presque toujours préférable de les créer avec une portée locale, car Luau accède plus rapidement aux variables locales qu'aux variables globales. Pour donner une portée locale à une variable, mettez le mot-clé local avant le nom de la variable lorsque vous lui attribuez une valeur. Pour plus d'informations sur la portée dans Luau, consultez Portée.


local nilVar
local x = 10
local word = "Hello"
local boolean = true

print(nilVar) -- nil
print(x) -- 10
print(word) -- Hello
print(boolean) -- true

Assigner des valeurs à plusieurs variables

Vous pouvez assigner des valeurs à plusieurs variables en une seule ligne en séparant chaque paire variable-valeur par une virgule. Si vous avez plus de variables que de valeurs, Luau attribue nil aux variables supplémentaires. Si vous avez plus de valeurs que de variables, Luau n'attribue pas les valeurs supplémentaires à des variables.


local a, b, c = 1, 2, 3
local d, e, f = 4, 5 -- variable supplémentaire
local g, h = 7, 8, 9 -- valeur supplémentaire

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

Changer des valeurs

Pour changer la valeur d'une variable, attribuez-lui une autre valeur.


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

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