Lua allows multiple assignment. Therefore, the syntax for assignment defines a list of variables on the left side and a list of expressions on the right side. The elements in both lists are separated by commas:
stat ::= varlist1 `*=*` explist1 varlist1 ::= var {`*,*` var} explist1 ::= exp {`*,*` exp}
Expressions are discussed in Expressions.
Before the assignment, the list of values is adjusted to the length of the list of variables. If there are more values than needed, the excess values are thrown away. If there are fewer values than needed, the list is extended with as many *nil*'s as needed. If the list of expressions ends with a function call, then all values returned by this call enter in the list of values, before the adjustment (except when the call is enclosed in parentheses; see Expressions).
The assignment statement first evaluates all its expressions and only then are the assignments performed. Thus the code
i = 3 i, a[i] = i+1, 20
sets a[3]
to 20, without affecting a[4]
because the i
in a[i]
is evaluated (to 3) before it is assigned 4. Similarly, the line
x, y = y, x
exchanges the values of x
and y
.
The meaning of assignments to global variables and table fields can be changed via metatables. An assignment to an indexed variable t[i] = val
is equivalent to settable_event(t,i,val)
. (See Metatables for a complete description of the settable_event
function. This function is not defined or callable in Lua. We use it here only for explanatory purposes.)
An assignment to a global variable x = val
is equivalent to the assignment _env.x = val
, which in turn is equivalent to
settable_event(_env, "x", val)
where _env
is the environment of the running function. (The _env
variable is not defined in Lua. We use it here only for explanatory purposes.)