use math

Mathematical functions and constants.

Constants

Functions

fn abs

Absolute value.

Signature: (x:f64 -- result:f64)

Example:

-5.0 math::abs print  // 5.0

fn acos

Arc cosine (inverse cosine).

Signature: (x:f64 -- result:f64)

Example:

1.0 math::acos print  // 0.0

fn asin

Arc sine (inverse sine).

Signature: (x:f64 -- result:f64)

Example:

0.0 math::asin print  // 0.0

fn atan2

Two-argument arc tangent. Returns the angle in radians between the positive x-axis and the point (x, y). More useful than atan for computing angles because it handles all quadrants.

Signature: (y:f64 x:f64 -- result:f64)

Example:

1.0 1.0 math::atan2 print  // ~0.785 (Pi/4)

fn atan

Arc tangent (inverse tangent).

Signature: (x:f64 -- result:f64)

Example:

0.0 math::atan print  // 0.0

fn cbrt

Cube root.

Signature: (x:f64 -- result:f64)

Example:

8.0 math::cbrt print  // 2.0

fn cb

Cube a number.

Signature: (x:f64 -- result:f64)

Example:

2.0 math::cb print  // 8.0

fn ceil

Ceiling (round up).

Signature: (x:f64 -- result:f64)

Example:

2.3 math::ceil print  // 3.0

fn clamp

Clamp value to range.

Signature: (x:f64 min_val:f64 max_val:f64 -- result:f64)

Example:

15.0 0.0 10.0 math::clamp print  // 10.0

fn cos

Cosine of angle in radians.

Signature: (x:f64 -- result:f64)

Example:

0.0 math::cos print  // 1.0

fn deg_to_rad

Convert degrees to radians.

Signature: (degrees:f64 -- radians:f64)

Example:

180.0 math::deg_to_rad print  // ~3.14159

fn exp

Exponential function (e^x).

Signature: (x:f64 -- result:f64)

Example:

1.0 math::exp print  // ~2.718 (e)

fn fac

Factorial (n!).

Signature: (n:i64 -- result:i64)

Example:

5 math::fac print  // 120

fn floor

Floor (round down).

Signature: (x:f64 -- result:f64)

Example:

2.7 math::floor print  // 2.0

fn fmod

Floating-point modulo (remainder). Returns the remainder of x/y with the same sign as x.

Signature: (x:f64 y:f64 -- result:f64)

Example:

5.5 2.0 math::fmod print  // 1.5

fn hypot

Hypotenuse (Euclidean distance). Computes sqrt(xx + yy) without intermediate overflow or underflow.

Signature: (x:f64 y:f64 -- result:f64)

Example:

3.0 4.0 math::hypot print  // 5.0

fn inv

Reciprocal (1/x).

Signature: (x:f64 -- result:f64)

Example:

4.0 math::inv print  // 0.25

fn lerp

Linear interpolation between two values.

Signature: (a:f64 b:f64 t:f64 -- result:f64)

Example:

0.0 10.0 0.5 math::lerp print  // 5.0

fn ln

Natural logarithm (base e).

Signature: (x:f64 -- result:f64)

Example:

2.718281828 math::ln print  // ~1.0

fn log10

Base-10 logarithm.

Signature: (x:f64 -- result:f64)

Example:

100.0 math::log10 print  // 2.0

fn log

Logarithm with arbitrary base.

Signature: (x:f64 base:f64 -- result:f64)

Example:

8.0 2.0 math::log print  // 3.0

fn max

Maximum of two values.

Signature: (a:any b:any -- result:any)

Example:

3 7 math::max print  // 7

fn min

Minimum of two values.

Signature: (a:any b:any -- result:any)

Example:

3 7 math::min print  // 3

fn pow

Power function.

Signature: (base:f64 exp:f64 -- result:f64)

Example:

2.0 3.0 math::pow print  // 8.0

fn rad_to_deg

Convert radians to degrees.

Signature: (radians:f64 -- degrees:f64)

Example:

3.141592653589793 math::rad_to_deg print  // 180.0

fn round

Round to nearest integer.

Signature: (x:f64 -- result:f64)

Example:

2.5 math::round print  // 3.0

fn sin

Sine of angle in radians.

Signature: (x:f64 -- result:f64)

Example:

0.0 math::sin print  // 0.0

fn sqrt

Square root.

Signature: (x:f64 -- result:f64)

Example:

4.0 math::sqrt print  // 2.0

fn sq

Square a number.

Signature: (x:f64 -- result:f64)

Example:

3.0 math::sq print  // 9.0

fn tan

Tangent of angle in radians.

Signature: (x:f64 -- result:f64)

Example:

0.0 math::tan print  // 0.0

fn within

Check if value is within range (inclusive).

Signature: (x:any min_val:any max_val:any -- result:i64)

Example:

5 0 10 math::within print  // 1

fn sinh

Hyperbolic sine.

Signature: (x:f64 -- result:f64)

Example:

1.0 math::sinh print  // ~1.175

fn cosh

Hyperbolic cosine.

Signature: (x:f64 -- result:f64)

Example:

0.0 math::cosh print  // 1.0

fn tanh

Hyperbolic tangent.

Signature: (x:f64 -- result:f64)

Example:

0.0 math::tanh print  // 0.0

fn asinh

Inverse hyperbolic sine.

Signature: (x:f64 -- result:f64)

Example:

0.0 math::asinh print  // 0.0

fn acosh

Inverse hyperbolic cosine.

Signature: (x:f64 -- result:f64)

Example:

1.0 math::acosh print  // 0.0

fn atanh

Inverse hyperbolic tangent.

Signature: (x:f64 -- result:f64)

Example:

0.0 math::atanh print  // 0.0

fn log2

Base-2 logarithm.

Signature: (x:f64 -- result:f64)

Example:

8.0 math::log2 print  // 3.0

fn exp2

Exponential base 2 (2^x).

Signature: (x:f64 -- result:f64)

Example:

3.0 math::exp2 print  // 8.0

fn trunc

Truncate toward zero.

Signature: (x:f64 -- result:f64)

Example:

-2.7 math::trunc print  // -2.0

fn sign

Sign function.

Signature: (x:f64 -- result:f64)

Example:

-5.0 math::sign print  // -1.0

See also: Vectors (Vec2, Vec3, Vec4) | Matrices & Quaternions (Mat4, Quat)