Skip to content

Division

This page documents both integer and floating-point division operations.

Integer Division /

Performs integer division, returning the quotient (truncated toward negative infinity). Supports such types and their combinations: i32, i64, I64, f64, F64.

Basic Usage

↪ (/ 10 3)
3
↪ (/ -10 3)
-4
↪ (/ 10 -3)
-4
↪ (/ [-1 -2 -3] 3)
[-1 -1 -1]
↪ (/ [10 -10 3] 2.1)
[4 -5 1]
↪ (/ 3.1 [1 2 -3])
[3.00 1.00 -2.00]

Division by Zero and Null Handling

↪ (/ 5 0)
0Nl
↪ (/ 6 0.00)
0Nl
↪ (/ 0Nl 5)
0Nl
↪ (/ 0Ni 5)
0Ni
↪ (/ 0Nf 5)
0Nf
↪ (/ 5 0Ni)
0Nl

Info

  • Numeric types: i32 (int32), i64 (int64), f64 (float64)
  • Null values: 0Ni (null int32), 0Nl (null int64), 0Nf (null float64)
  • Returns the quotient (integer part) of the division
  • Division by zero returns null (0Nl)
  • Division with any null value returns null

Warning

Division by zero does not throw an error, it returns a null value

Floating-Point Division div

Performs floating-point division, always returning a float result. Supports such types and their combinations: i32, i64, I64, f64, F64.

Basic Usage

↪ (div 10i 5i)
2.0

↪ (div 3i 5i)
0.6

↪ (div -10i 5i)
-2.0

↪ (div -9i 5i)
-1.8

↪ (div 10i 5.0)
2.0

↪ (div -3i 5.0)
-0.6

Vector Division

↪ (div [1 2 3] 3)
[0.33 0.67 1.00]

↪ (div [1 2 3] 2.1)
[0.48 0.95 1.43]

↪ (div 3.1 [1 2 3])
[3.10 1.55 1.03]

Division by Zero and Null Handling

↪ (div 3i 0i)
0Nf

↪ (div -3i 0i)
0Nf

↪ (div 3i 0.0)
0Nf

↪ (div -3i 0.0)
0Nf

Info

  • Numeric types: i32 (int32), i64 (int64), f64 (float64)
  • Null values: 0Nf (null float64)
  • Always returns float, unlike / which performs integer division
  • Division by zero returns null (0Nf)
  • Division with any null value returns null

Warning

Division by zero does not throw an error, it returns a null value

Tip

Use div for floating-point division with decimal results, use / for integer division (quotient)