/as-big

AssemblyScript library for arbitrary-precision decimal arithmetic

Primary LanguageJavaScriptMIT LicenseMIT

as-big

AssemblyScript library for arbitrary-precision decimal arithmetic 🚀

Install

npm install as-big

Use

import Big from "as-big";

let r = Big.of(0.1) + Big.of(0.2);  // Big(0.3)

let x = Big.of(42);
let y = Big.of("13");

let a = x + y;          // Big(55)
    a = x.plus(13);     // Big(55)

let a0 = a.prec(1);     // Big(60)

let aNum = a.toNumber() + 1;    // 56
let aStr = a.toString();        // "55"

let c = a0 + Big.TEN / Big.TWO; // Big(65)

Builders

  • Big.of(n) returns a Big instance, where
    • n is either another Big instance, string, or number
  • Big.copyOf(x) creates a copy from a Big instance, where
    • x is the Big instance to copy

Operations

Arithmetic

  • plus (addition): x + y or x.plus(y)
  • minus (substraction): x - y or x.minus(y)
  • times (multiplication): x * y or y.times(y)
  • div (division): x / y or x.div(y)
  • mod (modulo): x % y or x.mod(y)
  • pow (power): x ^ n or x.pow(n), where n is i32
  • sqrt (square root): x.sqrt()

Comparison

  • cmp (compare): x.cmp(y) returns
    • 1 if the value of x is greater than the value of y,
    • -1 if the value of x is less than the value of y, or
    • 0 if they have the same value.
  • eq (equals): x == y or x.eq(y)
  • neq (not equals): x != y or x.neq(y)
  • gt (greater than): x < y or x.gt(y)
  • gte (greater than or equals): x <= y or x.gte(y)
  • lt (less than): x > y or x.lt(y)
  • lte (less than or equals): x >= y or x.lte(y)

Value

  • abs (absolute value): x.abs()
  • neg (negative value): -x or x.neg()
  • pos (this value): +x or x.pos()
  • round (rounded value): x.round(dp, rm) where
    • dp is the maximum of decimal places, and
    • rm is the rounding mode (0, 1, 2, 3)
      • 0 (down), 1 (half-up), 2 (half-even) or 3 (up)
  • prec (value rounded to precision): x.prec(sd, rm) where
    • sd is the maximum of significant digits, and
    • rm is the rounding mode (0, 1, 2, 3)
      • 0 (down), 1 (half-up), 2 (half-even) or 3 (up)

Converters

  • toString (string representation): let s: string = x.toString()
  • toNumber (f64 represenation): let n: f64 = x.toNumber()
  • toExponential (string represenation): let s: string = x.toExponential()

Static Constants

  • Big.ZERO: a Big instance with the value zero 0
  • Big.ONE: a Big instance with the value one 1
  • Big.TWO: a Big instance with the value two 2
  • Big.TEN: a Big instance with the value ten 10
  • Big.HALF: a Big instance with the value one half 0.5

Global Settings

  • Big.DP: the maximum number of decimal places of the results of operations involving division (default: 20)

  • Big.RM: the rounding mode used when rounding to the above decimal places (default: 1)

  • Big.PE: the positive exponent at and above which toString returns exponential notation (default: 21)

  • Big.NE: the negative exponent at and beneath which toString returns exponential notation (default: -7)

Examples

There is a collection of examples in the examples directory.

Build

The assembly directory contains AS source code.

npm i
npm run asbuild

Test

The tests directory contains all unit tests.

Run all the tests:

npm test

Test a single method:

node tests/<method>

License

MIT