docs/ecma334/14.13.xml

   1 <?xml version="1.0"?>
   2 <clause number="14.13" title="Assignment operators">
   3   <paragraph>The assignment operators assign a new value to a variable, a property, event, or an indexer element. <grammar_production><name>assignment</name> : <rhs><non_terminal where="14.6">unary-expression</non_terminal><non_terminal where="14.13">assignment-operator</non_terminal><non_terminal where="14.14">expression</non_terminal></rhs></grammar_production><grammar_production><name><non_terminal where="14.13">assignment-operator</non_terminal></name> : one of <rhs><terminal>=</terminal><terminal>+=</terminal><terminal>-=</terminal><terminal>*=</terminal><terminal>/=</terminal><terminal>%=</terminal><terminal>&amp;=</terminal><terminal>|=</terminal><terminal>^=</terminal><terminal>&lt;&lt;=</terminal><terminal>&gt;&gt;=</terminal></rhs></grammar_production></paragraph>
   4   <paragraph>The left operand of an assignment must be an expression classified as a variable, a property access, an indexer access, or an event access. </paragraph>
   5   <paragraph>The = operator is called the simple assignment operator. It assigns the value of the right operand to the variable, property, or indexer element given by the left operand. The left operand of the simple assignment operator may not be an event access (except as described in <hyperlink>17.7.1</hyperlink>). The simple assignment operator is described in <hyperlink>14.13.1</hyperlink>. </paragraph>
   6   <paragraph>The operators formed by prefixing a binary operator with an = character are called the compound assignment operators. These operators perform the indicated operation on the two operands, and then assign the resulting value to the variable, property, or indexer element given by the left operand. The compound assignment operators are described in <hyperlink>14.13.2</hyperlink>. </paragraph>
   7   <paragraph>The += and -= operators with an event access expression as the left operand are called the event assignment operators. No other assignment operator is valid with an event access as the left operand. The event assignment operators are described in <hyperlink>14.13.3</hyperlink>. </paragraph>
   8   <paragraph>The assignment operators are right-associative, meaning that operations are grouped from right to left. For example, an expression of the form a = b = c is evaluated as a = (b = c). </paragraph>
   9 </clause>