🔢 Mathematical Operations
Module:
math/*| Operators: 16
Numeric operations for calculations, rounding, clamping, and randomization.
Operator Reference
math/abs
Absolute Value · 1 argument · returns number
Absolute value
| Parameter | Type | Description |
|---|---|---|
n | number | The number |
(math/abs -5) // => 5
math/min
Min · 2 or more · returns number
Minimum of values
| Parameter | Type | Description |
|---|---|---|
...nums | number[] | Numbers to compare |
(math/min 3 1 4) // => 1
math/max
Max · 2 or more · returns number
Maximum of values
| Parameter | Type | Description |
|---|---|---|
...nums | number[] | Numbers to compare |
(math/max 3 1 4) // => 4
math/clamp
Clamp · 3 arguments · returns number
Constrain value to range [min, max]
| Parameter | Type | Description |
|---|---|---|
n | number | The value to clamp |
min | number | Minimum bound |
max | number | Maximum bound |
(math/clamp 150 0 100) // => 100
math/floor
Floor · 1 argument · returns number
Round down to integer
| Parameter | Type | Description |
|---|---|---|
n | number | The number |
(math/floor 3.7) // => 3
math/ceil
Ceil · 1 argument · returns number
Round up to integer
| Parameter | Type | Description |
|---|---|---|
n | number | The number |
(math/ceil 3.2) // => 4
math/round
Round · 1–2 arguments · returns number
Round to nearest integer or specified decimals
| Parameter | Type | Description |
|---|---|---|
n | number | The number |
decimals | number | Decimal places |
(math/round 3.456 2) // => 3.46
math/pow
Pow · 2 arguments · returns number
Exponentiation (base^exp)
| Parameter | Type | Description |
|---|---|---|
base | number | The base |
exp | number | The exponent |
(math/pow 2 8) // => 256
math/sqrt
Sqrt · 1 argument · returns number
Square root
| Parameter | Type | Description |
|---|---|---|
n | number | The number |
(math/sqrt 16) // => 4
math/mod
Mod · 2 arguments · returns number
Modulo (remainder)
| Parameter | Type | Description |
|---|---|---|
a | number | Dividend |
b | number | Divisor |
(math/mod 7 3) // => 1
math/sign
Sign · 1 argument · returns number
Returns -1, 0, or 1 indicating sign
| Parameter | Type | Description |
|---|---|---|
n | number | The number |
(math/sign -42) // => -1
math/lerp
Linear Interpolation · 3 arguments · returns number
Linear interpolation between a and b by factor t
| Parameter | Type | Description |
|---|---|---|
a | number | Start value |
b | number | End value |
t | number | Interpolation factor (0-1) |
(math/lerp 0 100 0.5) // => 50
math/map
Map · 5 arguments · returns number
Map value from one range to another
| Parameter | Type | Description |
|---|---|---|
n | number | The value |
inMin | number | Input range minimum |
inMax | number | Input range maximum |
outMin | number | Output range minimum |
outMax | number | Output range maximum |
(math/map 5 0 10 0 100) // => 50
math/random
Random · 0 arguments · returns number
Random number between 0 (inclusive) and 1 (exclusive)
(math/random) // => 0.7234...
math/randomInt
Random Integer · 2 arguments · returns number
Random integer in range [min, max] (inclusive)
| Parameter | Type | Description |
|---|---|---|
min | number | Minimum (inclusive) |
max | number | Maximum (inclusive) |
(math/randomInt 1 6) // => 4
math/default
Default · 2 arguments · returns number
Return default if value is null, undefined, or NaN
| Parameter | Type | Description |
|---|---|---|
n | number | null | The value |
default | number | Default value |
(math/default null 0) // => 0