Add definition for compound assignment operators

This patch adds definition for compound-assignment operators to the P4
language specification. These operators provide a shorter syntax for
assigning the result of an arithmetic or bitwise operator. The proposed
definition of compound assignment operators is similar the
C99 specification.

https://en.cppreference.com/w/c/language/operator_assignment

Signed-off-by: Radostin Stoyanov <[email protected]>

Author: rst0git

p4-16/spec/P4-16-spec.mdk

@@ -3162,6 +3162,8 @@ side-effects. P4 expressions are evaluated as follows:
   the second operand is only evaluated if necessary.
 - The conditional operator `e1 ? e2 : e3` evaluates `e1`, and then
   either evaluates `e2` or `e3`.
+- Compound assignment expressions are evaluated as described in Section
+  [#sec-compound-assignment].
 - All other expressions are evaluated left-to-right as they appear in
   the source program.
 - Method and function calls are evaluated as described in Section
@@ -5228,6 +5230,42 @@ types (e.g. `structs`) are copied recursively, and all components
 of `header`s are copied, including "validity" bits. Assignment is
 not defined for `extern` values.
 
+### Compound assignment { #sec-compound-assignment }
+
+Compound assignment operators provide a shorter syntax for assigning
+the result of an arithmetic, bitwise or logical operator. The compound
+assignment operator expressions have the form `LHS op RHS`, where `op`
+is one of `+=`, `-=`, `*=`, `/=`, `%=`, `&=`, `|=`, `&&=`, `||=`, `^=`,
+`<<=`, `>>=`, `|+|=`, `|-|=`, and `LHS`, `RHS` are expressions with
+arithmetic types. The following table shows all P4 assignment operators and
+their equivalent.
+
+|----------|-----------------------------------|------------|---------------|
+| Operator | Operator name                     | Example    | Equivalent of |
++----------+:---------------------------------:+:----------:+:-------------:+
+| `=`      | basic assignment                  | `a = b`    | NA            |
+| `+=`     | addition assignment               | `a += b`   | `a = a + b`   |
+| `-=`     | subtraction assignment            | `a -= b`   | `a = a - b`   |
+| `*=`     | multiplication assignment         | `a *= b`   | `a = a * b`   |
+| `/=`     | division assignment               | `a /= b`   | `a = a / b`   |
+| `%=`     | modulo assignment                 | `a %= b`   | `a = a % b`   |
+| `&=`     | bitwise AND assignment            | `a &= b`   | `a = a & b`   |
+| `|=`     | bitwise OR assignment             | `a |= b`   | `a = a | b`   |
+| `&&=`    | logical AND assignment            | `a &&= b`  | `a = a && b`  |
+| `||=`    | logical OR assignment             | `a ||= b`  | `a = a || b`  |
+| `^=`     | bitwise XOR assignment            | `a ^= b`   | `a = a ^ b`   |
+| `<<=`    | bitwise left shift assignment     | `a <<= b`  | `a = a << b`  |
+| `>>=`    | bitwise right shift assignment    | `a >>= b`  | `a = a >> b`  |
+| `|+|=`   | saturating addition assignment    | `a |+|= b` | `a = a |+| b` |
+| `|-|=`   | saturating subtraction assignment | `a |-|= b` | `a = a |-| b` |
+|----------|-----------------------------------|----------- |---------------|
+
+The behavior of every builtin compound assignment expression with the form `E1 op= E2`,
+where `E1` is a modifiable l-value expression and `E2` is an r-value expression,
+is exactly the same as the behavior of the expression `E1 = E1 op E2`, except that
+`E1` is evaluated only once. Unlike normal assignments, compound assignments evaluate
+the left-hand side before evaluating the right-hand side.
+
 ## Empty statement { #sec-empty-stmt }
 
 The empty statement, written `;` is a no-op.

p4-16/spec/grammar.mdk

@@ -726,6 +726,20 @@ annotationToken
     | "?"
     | "."
     | "="
+    | "+="
+    | "-="
+    | "*="
+    | "/="
+    | "%="
+    | "&="
+    | "|="
+    | "&&="
+    | "||="
+    | "^="
+    | "<<="
+    | ">>="
+    | "|+|="
+    | "|-|="
     | ";"
     | "@"
     | UNKNOWN_TOKEN