List of operators
Warning
uCalc API Preview Release Notice:The uCalc engine has successfully transitioned to modern cross-platform environments. The next phase envolvessome structural changes, performance optimizations, and API refinements. The API is subject to breaking changesprior to the stable release. Please evaluate the preview version thoroughly before production use.
Precedence numbers are relative only—higher means tighter binding.
| Prec | Operator | Signature | Description |
|---|---|---|---|
| 50 | x + y | {x As Int} + {y As Int} As Int | Integer addition. |
| 50 | x - y | {x As Int} - {y As Int} As Int | Integer subtraction. |
| 60 | x * y | {x As Int} * {y As Int} As Int | Integer multiplication. |
| 60 | x / y | {x As Int} / {y As Int} As Int | Integer division (truncating). |
| 60 | x % y | {x As Int} % {y As Int} As Int | Integer remainder. |
| Prec | Operator | Signature | Description |
|---|---|---|---|
| 50 | x + y | {x} + {y} | Floating‑point addition. |
| 50 | x - y | {x} - {y} | Floating‑point subtraction. |
| 60 | x * y | {x} * {y} | Floating‑point multiplication. |
| 60 | x / y | {x} / {y} | Floating‑point division. |
| 60 | x \\ y | {x} \\ {y} = Trunc(x / y) | Integer‑style division on doubles. |
| 60 | x mod y | {x} mod {y} | Floating‑point modulo. |
| 70 | +x | +{x} | Unary plus. |
| 70 | -x | -{x} | Unary negation. |
| 90 | x! | {x}! | Factorial. |
| 80 | x ^ y | {x} ^ {y As Int} | Exponentiation with integer exponent. |
| 80 | x ^ y | {x} ^ {y} | Exponentiation with floating exponent. |
| Prec | Operator | Signature | Description |
|---|---|---|---|
| 50 | x + y | {ByHandle x As String} + {ByHandle y As AnyType} As String | String concatenation with automatic conversion. |
| 50 | x + y | {ByHandle x As AnyType} + {ByHandle y As String} As String | Concatenation (reverse order). |
| 50 | x + y | {x As String} + {y As String} As String | Pure string concatenation. |
| 30 | x & y | {x As Int} & {y As Int} As Int | Bitwise AND for integers. |
| 30 | x & y | {ByHandle x As AnyType} & {ByHandle y As AnyType} As String | String concatenation operator (VB‑style). |
| 60 | x * y | {x As String} * {y As size_t} As String | String repetition. |
| Prec | Operator | Signature | Description |
|---|---|---|---|
| 50 | ptr + n | {ByHandle x As AnyType Ptr} + {y As Int} As SameTypeAs:0 Ptr | Pointer addition. |
| 50 | ptr - n | {ByHandle x As AnyType Ptr} - {y As Int} As SameTypeAs:0 Ptr | Pointer subtraction. |
(String, Int, Double, and generic overloads)
| Prec | Operator | Signature | Description |
|---|---|---|---|
| 40 | x == y | {x As String} == {y As String} As Bool | String equality. |
| 40 | x <> y | {x As String} <> {y As String} As Bool | String inequality. |
| 40 | <, >, <=, >= | String versions | Lexicographic comparisons. |
| 40 | x == y | {x As Int} == {y As Int} As Bool | Integer equality. |
| 40 | x <> y | {x As Int} <> {y As Int} As Bool | Integer inequality. |
| 40 | <, >, <=, >= | Integer versions | Numeric comparisons. |
| 40 | x == y | {x} == {y} As Bool | Generic equality. |
| 40 | x <> y | {x} <> {y} As Bool | Generic inequality. |
| 40 | <, >, <=, >= | Generic versions | Type‑dependent comparisons. |
| Prec | Operator | Signature | Description |
|---|---|---|---|
| 50 | x + y | {x As Complex} + {y As Complex} As Complex | Complex addition. |
| 50 | x - y | {x As Complex} - {y As Complex} As Complex | Complex subtraction. |
| 60 | x * y | {x As Complex} * {y As Complex} As Complex | Complex multiplication. |
| 60 | x / y | {x As Complex} / {y As Complex} As Complex | Complex division. |
| 80 | x == y | {x As Complex} == {y As Complex} As Bool | Complex equality. |
| 80 | x <> y | {x As Complex} <> {y As Complex} As Bool | Complex inequality. |
| 80 | x ^ y | {x As Complex} ^ {y As Complex} As Complex | Complex exponentiation. |
| Prec | Operator | Signature | Description |
|---|---|---|---|
| 35 | !x | ! {x As Bool} As Bool | Logical NOT. |
| 35 | Not x | Not {x As Bool} As Bool | Alternative NOT. |
| 30 | x && y | {x As Bool} && {ByExpr y As Bool} As Bool | Logical AND (short‑circuit). |
| 30 | x And y | {x As Bool} And {ByExpr y As Bool} As Bool | Logical AND (non‑short‑circuit). |
| 30 | x AndAlso y | {x As Bool} AndAlso {ByExpr y As Bool} As Bool | Short‑circuit AND (VB‑style). |
| 20 | x || y | {x As Bool} || {ByExpr y As Bool} As Bool | Logical OR (short‑circuit). |
| 20 | x Or y | {x As Bool} Or {ByExpr y As Bool} As Bool | Logical OR (non‑short‑circuit). |
| 20 | x OrElse y | {x As Bool} OrElse {ByExpr y As Bool} As Bool | Short‑circuit OR (VB‑style). |
| Prec | Operator | Signature | Description |
|---|---|---|---|
| 35 | ~x | ~ {x As Int} As Int | Bitwise NOT. |
| 35 | Not x | Not {x Int} As Int | Alternative bitwise NOT. |
| 30 | x And y | {x As Int} And {y As Int} As Int | Bitwise AND. |
| 30 | x BitAnd y | {x As Int} BitAnd {y As Int} As Int | Explicit bitwise AND. |
| 20 | x | y | {x As Int} | {y As Int} As Int | Bitwise OR. |
| 20 | x Or y | {x As Int} Or {y As Int} As Int | Bitwise OR (keyword). |
| 20 | x BitOr y | {x As Int} BitOr {y As Int} As Int | Explicit bitwise OR. |
| 20 | x Xor y | {x As Int} Xor {y As Int} As Int | Bitwise XOR. |
| 45 | x << y | {x As Int} << {y As Int} As Int | Left shift. |
| 45 | x >> y | {x As Int} >> {y As Int} As Int | Right shift. |
| Prec | Assoc | Operator | Signature | Description |
|---|---|---|---|---|
| 15 | Right‑to‑Left | x = y | {ByRef x As AnyType} = {y As SameTypeAs:0} As SameTypeAs:0 | Generic assignment. |
| 15 | Right‑to‑Left | x = y | {ByRef x As String} = {y As String} As String | String assignment. |
| 15 | Right‑to‑Left | x = y | {ByRef x As Complex} = {y As Complex} As Complex | Complex assignment. |
| Operator | Description |
|---|---|
++x | Prefix increment. |
x++ | Postfix increment. |
--x | Prefix decrement. |
x-- | Postfix decrement. |
| Operator | Description |
|---|---|
; | Statement separator. |
, | Argument separator (comma operator). |