Math in AssemblyScript is available in multiple variants.
|NativeMath||WebAssembly implementation for |
|NativeMathf||WebAssembly implementation for |
By default, the global
Math object is an alias of
Mathf is an alias of
# Using JSMath
By default, the compiler utilizes
NativeMath which is implemented in WebAssembly directly, but where small module size is more important than performance, one can opt to override the default by adding
--use Math=JSMath on the command line, essentially aliasing
JSMath instead, which maps to an import of the browser's math implementation. Naturally, this option requires importing the browser's
Math object as a whole, but does not require seeding / is not seedable. Generated bindings automatically take care of importing the browser's math in this scenario.
# Static members
T below substitutes either
f64 depending on the implementation used. Note that
Math is not actually generic, but concrete implementations like
Mathf have an identical interface that only differs in the implementation's floating-point precision denoted by
const E: T
The base of natural logarithms, e, approximately 2.718.
const LN2: T
The natural logarithm of 2, approximately 0.693.
const LN10: T
The natural logarithm of 10, approximately 2.302.
const LOG2E: T
The base 2 logarithm of e, approximately 1.442.
const LOG10E: T
The base 10 logarithm of e, approximately 0.434.
const PI: T
The ratio of the circumference of a circle to its diameter, approximately 3.14159.
const SQRT1_2: T
The square root of 1/2, approximately 0.707.
const SQRT2: T
The square root of 2, approximately 1.414.
function abs(x: T): T
Returns the absolute value of
function acos(x: T): T
Returns the arccosine (in radians) of
function acosh(x: T): T
Returns the hyperbolic arc-cosine of
function asin(x: T): T
Returns the arcsine (in radians) of
function asinh(x: T): T
Returns the hyperbolic arcsine of
function atan(x: T): T
Returns the arctangent (in radians) of
function atan2(y: T, x: T): T
Returns the arctangent of the quotient of its arguments.
function atanh(x: T): T
Returns the hyperbolic arctangent of
function cbrt(x: T): T
Returns the cube root of
function ceil(x: T): T
Returns the smallest integer greater than or equal to
function clz32(x: T): T
Returns the number of leading zero bits in the 32-bit binary representation of
function cos(x: T): T
Returns the cosine (in radians) of
function cosh(x: T): T
Returns the hyperbolic cosine of
function exp(x: T): T
Returns e to the power of
function expm1(x: T): T
Returns e to the power of
x, minus 1.
function floor(x: T): T
Returns the largest integer less than or equal to
function fround(x: T): T
Returns the nearest 32-bit single precision float representation of
function hypot(value1: T, value2: T): T
Returns the square root of the sum of squares of its arguments.
function imul(a: T, b: T): T
Returns the result of the C-like 32-bit multiplication of
function log(x: T): T
Returns the natural logarithm (base e) of
function log10(x: T): T
Returns the base 10 logarithm of
function log1p(x: T): T
Returns the natural logarithm (base e) of 1 +
function log2(x: T): T
Returns the base 2 logarithm of
function max(value1: T, value2: T): T
Returns the largest-valued number of its arguments.
function min(value1: T, value2: T): T
Returns the lowest-valued number of its arguments.
function pow(base: T, exponent: T): T
baseto the power of
function random(): T
Returns a pseudo-random number in the range from 0.0 inclusive up to but not including 1.0.
Math.randomneeds a way to seed the random number generator, which is achieved with a special import
env.seedreturning the seed as an
f64value. Generated bindings and WASI take care of it automatically.
function round(x: T): T
Returns the value of
xrounded to the nearest integer.
function sign(x: T): T
Returns the sign of
x, indicating whether the number is positive, negative or zero.
function signbit(x: T): bool
Returns whether the sign bit of
function sin(x: T): T
Returns the sine of
function sinh(x: T): T
Returns the hyperbolic sine of
function sqrt(x: T): T
Returns the square root of
function tan(x: T): T
Returns the tangent of
function tanh(x: T): T
Returns the hyperbolic tangent of
function trunc(x: T): T
Returns the integer part of
xby removing any fractional digits.
Math with all its quirks. For example,
Math.round always rounds towards
Math.imul and similar functions operate on
number, which is
f64 in AssemblyScript. Hence, using WebAssembly's math instructions directly where possible is often more efficient.