The symbol = is compiled into one of two assignment operators:
- A list assignment operator is used if the left-hand side (LHS) of a = is some kind of aggregate.
- A scalar assignment operator is used otherwise.
The following are considered to be aggregates:
- Any expression in parentheses (e.g. (...))
- An array (e.g. @array)
- An array slice (e.g. @array[...])
- A hash (e.g. %hash)
- A hash slice (e.g. @hash{...})
- Any of the above preceded by my, our or local
There are two differences between the operators.
Context of Operands
The two operators differ in the context in which their operands are evaluated.
- The scalar assignment evaluates both of its operands in scalar context.
- The list assignment evaluates both of its operands in list context.
Value(s) Returned
The two operators differ in what they return.
| Returns | Context in which Assignment Operator is Evaluated |
| scalar | list |
| Operator | scalar assignment | The LHS as an lvalue | The LHS as an lvalue |
| list assignment | The number of scalars returned by the RHS | The scalars returned by the LHS as lvalues |
Note that the right-hand side is used for the list assignment in scalar context.
Examples
| Examples | | Context in which Assignment Operator is Evaluated |
| scalar | list |
| Operator | scalar assignment | # @array evaluated in scalar context.
my $count = @array;
| # The s/// operates on $copy.
(my $copy = $str) =~ s/\\/\\\\/g;
| # Prints $x.
print($x = $y);
|
| list assignment | # @array evaluated in list context.
my @copy = @array;
# @array evaluated in list context.
my ($first) = @array;
| # Only dies if f() returns an empty list.
# This does not die if f() returns a
# false scalar like zero or undef.
my ($x) = f() or die;
my $count = () = f();
| # Prints @x.
print(@x = @y);
|
Related topics:
Update: Added examples.
Update: Incorporated JavaFan's additions.
Update: Removed list slices and mentioned state.
Update: One of the examples in the scalar context column did not depend on context. It has been moved to its own column. Also, added short explanations of examples.
Update: Reworded to not say there are only two assignment operators, because += and such are also assignment operators.
Update: Reworded to include new fangled []->@* to the list of aggregates.
Posts are HTML formatted. Put <p> </p> tags around your paragraphs. Put <code> </code> tags around your code and data!
Titles consisting of a single word are discouraged, and in most cases are disallowed outright.
Read Where should I post X? if you're not absolutely sure you're posting in the right place.
Please read these before you post! —
Posts may use any of the Perl Monks Approved HTML tags:
- a, abbr, b, big, blockquote, br, caption, center, col, colgroup, dd, del, details, div, dl, dt, em, font, h1, h2, h3, h4, h5, h6, hr, i, ins, li, ol, p, pre, readmore, small, span, spoiler, strike, strong, sub, summary, sup, table, tbody, td, tfoot, th, thead, tr, tt, u, ul, wbr
You may need to use entities for some characters, as follows. (Exception: Within code tags, you can put the characters literally.)
| |
For: |
|
Use: |
| & | | & |
| < | | < |
| > | | > |
| [ | | [ |
| ] | | ] |
Link using PerlMonks shortcuts! What shortcuts can I use for linking?
See Writeup Formatting Tips and other pages linked from there for more info.