Built in functions

To provide direct (compile to opcode) access to native WebAssembly operations, the following functions plus a few TS/JS-like constants are provided in the global scope:

Math

• NaN: f32 | f64
  NaN (not a number) as a 32-bit or 64-bit float depending on context.

• Infinity: f32 | f64
  Positive infinity as a 32-bit or 64-bit float depending on context.

• isNaN<T = f32 | f64>(value: T): bool
  Tests if a 32-bit or 64-bit float is NaN.

• isFinite<T = f32 | f64>(value: T): bool
  Tests if a 32-bit or 64-bit float is finite, that is not NaN or +/-Infinity.

• clz<T = i32 | i64>(value: T): T
  Performs the sign-agnostic count leading zero bits operation on a 32-bit or 64-bit integer. All zero bits are considered leading if the value is zero.

• ctz<T = i32 | i64>(value: T): T
  Performs the sign-agnostic count tailing zero bits operation on a 32-bit or 64-bit integer. All zero bits are considered trailing if the value is zero.

• popcnt<T = i32 | i64>(value: T): T
  Performs the sign-agnostic count number of one bits operation on a 32-bit or 64-bit integer.

• rotl<T = i32 | i64>(value: T, shift: T): T
  Performs the sign-agnostic rotate left operation on a 32-bit or 64-bit integer.

• rotr<T = i32 | i64>(value: T, shift: T): T
  Performs the sign-agnostic rotate right operation on a 32-bit or 64-bit integer.

• abs<T = i32 | i64 | f32 | f64>(value: T): T
  Computes the absolute value of an integer or float.

• max<T = i32 | i64 | f32 | f64>(left: T, right: T): T
  Determines the maximum of two integers or floats. If either operand is NaN, returns NaN.

• min<T = i32 | i64 | f32 | f64>(left: T, right: T): T
  Determines the minimum of two integers or floats. If either operand is NaN, returns NaN.

• ceil<T = f32 | f64>(value: T): T
  Performs the ceiling operation on a 32-bit or 64-bit float.

• floor<T = f32 | f64>(value: T): T
  Performs the floor operation on a 32-bit or 64-bit float.

• copysign<T = f32 | f64>(x: T , y: T): T
  Composes a 32-bit or 64-bit float from the magnitude of x and the sign of y.

• nearest<T = f32 | f64>(value: T): T
  Rounds to the nearest integer tied to even of a 32-bit or 64-bit float.

• reinterpret<T = i32 | i64 | f32 | f64>(value: *): T
  Reinterprets the bits of the specified value as type T. Valid reinterpretations are u32/i32 to/from f32 and u64/i64 to/from f64.

• sqrt<T = f32 | f64>(value: T): T
  Calculates the square root of a 32-bit or 64-bit float.

• trunc<T = f32 | f64>(value: T): T
  Rounds to the nearest integer towards zero of a 32-bit or 64-bit float.

Memory access

• load<T>(ptr: usize, constantOffset?: usize): T
  Loads a value of the specified type from memory. Equivalent to dereferncing a pointer in other languages.

• store<T>(ptr: usize, value: T, constantOffset?: usize): void
  Stores a value of the specified type to memory. Equivalent to dereferencing a pointer in other languages when assigning a value.

• sizeof<T>(): usize
  Determines the byte size of the specified core or class type. Compiles to a constant.

• offsetof<T>(fieldName?: string): usize
  Determines the offset of the specified field within the given class type. Returns the class type's end offset if field name has been omitted. Compiles to a constant.

Note that constantOffset arguments must be compile-time constants (const global or local). Similarly, fieldName arguments must be string literals.

Control flow

• select<T>(ifTrue: T, ifFalse: T, condition: bool): T
  Selects one of two pre-evaluated values depending on the condition.

• unreachable(): *
  Emits an unreachable operation that results in a runtime error when executed. Both a statement and an expression of any type.

Host operations

• current_memory(): i32
  Returns the current memory size in units of pages. One page is 64kb.

• grow_memory(value: i32): i32
  Grows linear memory by a given unsigned delta of pages. One page is 64kb. Returns the previous memory size in units of pages or -1 on failure. Note that calling grow_memory where a memory manager is present might break it.

Other

• parseInt(str: string, radix?: i32): i64
  Parses a string to a 64-bit integer. Returns 0 on invalid inputs unlike NaN in JS.

• parseFloat(str: string): f64
  Parses a string to a 64-bit float. Returns NaN on invalid inputs.

• changetype<T>(value: *): T
  Changes the type of a value to another one. Useful for casting class instances to their pointer values and vice-versa.

• assert<T>(isTrueish: T, message?: string): T
  Traps if the specified value is not true-ish, otherwise returns the non-nullable value.