third

Author: JPryce-Aklundh

modules/ROOT/pages/expressions/mathematical-operators.adoc

@@ -168,57 +168,87 @@ RETURN p.discountPrice AS discountPrice
 
 1+d|Rows: 1
 |===
+
 
-[[precedence]]
+[[order-of-precedence]]
 == Order of precedence
 
-The following list details the order of precedence of the mathematical operators in ascending order:
+The following table details the order of precedence of the mathematical operators in ascending order.
+Note, the lower the precedence level, the higher the binding power of the operands.
+Also note, if parentheses `()` are used, any operation within them takes precedence, overriding the default order of precedence.
 
-.Mathematical operators order of precedence
-[options="header"]
+.Mathematical operators: order of precedence
+[options="header"cols="a,2a,2a"]
 |===
-
-| Precedence | Operators | Associativity
-
 | Precedence | Operators | Associativity
 
-| 1 | Unary negation (`-`), Unary positive (`+`) | Right to left
+| 1 | Unary negation (`-`), unary positive (`+`) | Right to left
 | 2 | Exponentiation (`^`) | Right to left
-| 3 | Multiplication (`*`), Division (`/`), Modulo (`%`) | Left to right
-| 4 | Addition (`+`), Subtraction (`-`) | Left to right
+| 3 | Multiplication (`*`), division (`/`), modulo division (`%`) | Left to right
+| 4 | Addition (`+`), subtraction (`-`) | Left to right
 
 |===
 
 Operators within the same precedence group are evaluated based on associativity.
 
-.Combining mathematical operators
+.Expression with several different mathematical operations
 [source, cypher]
 ----
-RETURN -50 + 6 * 3 - 100 / 5 ^ 2 % +12 AS result
+RETURN (((-50) + (6 * 3)) - ((100 / (5 ^ 2)) % 12)) AS result
 ----
 
 .Result
 [role="queryresult",options="header,footer",cols="1*<m"]
 |===
 | result
 
-| -35
+| -36
 
 1+d|Rows: 1
 |===
 
-.Order of Evaluation
-[options="header"]
+.Order of evaluation
+[options="header", cols="a,2a,a"]
 |===
 | Precedence | Operation | Result
 
 | 1 | Unary negation (`-50`) | `-50`
-| 1 | Unary positive (`+12`) | `12`
 | 2 | Exponentiation (`5 ^ 2`) | `25`
-| 3 | Division (`100 / 25`) | `4`
 | 3 | Multiplication (`6 * 3`) | `18`
-| 3 | Multiplication (`4 * 12`) | `48`
-| 3 | Modulo (`48 % 5`) | `3`
+| 3 | Division (`100 / 25`) | `4`
+| 3 | Modulo division (`4 % 12`) | `4`
 | 4 | Addition (`-50 + 18`) | `-32`
-| 4 | Subtraction (`-32 - 3`) | `-35`
+| 4 | Subtraction (`-32 - 4`) | `-36`
+
+|===
+
+Only bracketing some of the operations within parentheses will change the order of precedence and may, therefore, change the result of an expression.
+
+.Parenthesizing single operation
+[source, cypher]
+----
+RETURN (-50 + 6) * 3 - 100 / 5 ^ 2 % 12 AS result
+----
+
+.Result
+[role="queryresult",options="header,footer",cols="1*<m"]
+|===
+| result
+
+| -136
+
+1+d|Rows: 1
+|===
+
+.Changed order of evaluation
+[options="header",cols="a,2a,a"]
+|===
+| Precedence | Operation | Result
+
+| 1 | Parenthesized operation (`-50 + 6`) | `-44`
+| 2 | Exponentiation (`5 ^ 2`) | `25`
+| 3 | Multiplication (`-44 * 3`) | `132`
+| 3 | Division (`100 / 25`) | `4`
+| 3 | Modulo division (`4 % 12`) | `4`
+| 4 | Subtraction (`-132 - 4`) |  `-136`
 |===