Operators

Operators allow you to assign values to variables, compare values, and define conditional statements. Arcade supports the following operators.

Arithmetic operators

Arithmetic operators are used to perform arithmetic on numbers. See Type casting - Arithmetic statements to learn the casting behavior if either operand is not a number.

The increment/decrement by one operators have pre and post versions that differ in what they return. The pre increment version adds one to the variable and returns the new value while the post increment adds one and then returns the initial value of the variable.

1
2
3
4
5
6
7
// Pre increment example
var x = 10;
++x  // x is now 11 and the value 11 is returned

// Post increment example
var x = 10;
x++ // x is now 11 but the value of 10 is returned.

Assignment operators

Assignment operators are used to assign values to variables. See Type casting - Assignment statements to learn the implicit casting behaviors during variable assignment.

1
2
3
// Add assign
var x = 10;
x+=5  // x is now 15

Comparison operators

Comparison operators compare the values of two numbers. See Type casting - Comparison statements to learn the casting behavior of either operand.

Comparison operators attempt to coerce text to a number when comparing a text value to a number. The == and != operators don't do any coercion of types. If the types are different, then they are not equal.

1
2
3
4
5
6
7
8
10 == "10"  // returns false
10 != "10"  // returns true
10 > "10"   // returns false
10 >= "10"  // returns true
10 < "10"   // returns false
10 <= "10"  // returns true
9  < "10"   // returns true
11 < "10"   // returns false

For arrays, dictionaries, and geometry types, comparisons are a pointer check to see if they are the same object. Internal values of the object are not checked.

1
2
3
4
var a1 = [1,2,3]
var a2 = [1,2,3]
a1 == a2  // evaluates to false since they are not the same object.
a1 == a1  // evaluates to true since they are the same object.

Comparing DateOnly or Date values with Time values will throw an error.

Logical operators

Logical operators specify whether two conditions should be grouped together or evaluated separately. See Type casting - Logical statements to learn the casting behavior if either operand is not a boolean.

1
2
3
if(!IsEmpty($feature.MyField)){
  return "This field has a value";
}

Unary operators

Unary operators indicate if a value is positive or negative. See Type casting - Unary statements to learn the casting behavior if either operand is not a number.

Bitwise operators

Since 1.11

Bit operators work with 32 bit numbers.

Bitwise operators will perform their operation on the binary representation of the number provided to the operator, and will return a standard numerical value.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
7 & 14
// converts to 0111 and 1110
// result is 0110, which returns 6

7 | 14
// result is 1111, which returns 15

7 ^ 14
// result is 1001, which returns 9

~ 7
// converts to 00000000000000000000000000000111
// result is 11111111111111111111111111111000 (inverted operand)
// returns -8

7 << 2
// shift 00000000000000000000000000000111 two bits to the left
// result is 00000000000000000000000000011100
// returns 28

7 >> 2
// shift 00000000000000000000000000000111 two bits to the right
// result is 000000000000000000000000000001
// returns 1

-7 >> 2
// shift 11111111111111111111111111111001 two bits to the right
// result is 11111111111111111111111111111110
// returns -2

-7 >>> 2
// shift 11111111111111111111111111111001 two bits to the right
// result is 00111111111111111111111111111110
// returns 1073741822