https://github.com/javiercejudo/arbitrary-precision
:100: Arbitrary precision
https://github.com/javiercejudo/arbitrary-precision
arbitrary-precision bignumber decimal precision
Last synced: 3 months ago
JSON representation
:100: Arbitrary precision
- Host: GitHub
- URL: https://github.com/javiercejudo/arbitrary-precision
- Owner: javiercejudo
- License: mit
- Created: 2015-07-18T16:11:37.000Z (almost 10 years ago)
- Default Branch: master
- Last Pushed: 2024-04-24T11:34:07.000Z (about 1 year ago)
- Last Synced: 2024-04-24T15:38:12.025Z (about 1 year ago)
- Topics: arbitrary-precision, bignumber, decimal, precision
- Language: JavaScript
- Homepage: http://npmjs.com/package/arbitrary-precision
- Size: 19.5 KB
- Stars: 4
- Watchers: 2
- Forks: 0
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# arbitrary-precision
[](https://travis-ci.org/javiercejudo/arbitrary-precision)
[](https://coveralls.io/r/javiercejudo/arbitrary-precision?branch=master)
[](https://codeclimate.com/github/javiercejudo/arbitrary-precision)
Abstraction for decimal functionality in
[big.js](https://github.com/MikeMcl/big.js),
[bignumber.js](https://github.com/MikeMcl/bignumber.js),
[decimal.js](https://github.com/MikeMcl/decimal.js)
and others via adapters.
## Install
npm i arbitrary-precision
## Adapters
- [[adapter]](https://github.com/javiercejudo/bigjs-adapter) [[lib]](https://github.com/MikeMcl/big.js) big.js
- [[adapter]](https://github.com/javiercejudo/bignumberjs-adapter) [[lib]](https://github.com/MikeMcl/bignumber.js) bignumber.js
- [[adapter]](https://github.com/javiercejudo/decimaljs-adapter) [[lib]](https://github.com/MikeMcl/decimal.js) decimal.js
- [[adapter]](https://github.com/javiercejudo/floating-adapter) [[lib]](https://github.com/javiercejudo/floating) floating
See [up to date list](https://www.npmjs.com/browse/keyword/arbitrary-precision-adapter).
## Usage
```js
var decimalFactory = require('arbitrary-precision');
var adapter = require('floating-adapter'); // See adapters section for full list
var Decimal = decimalFactory(adapter);
```
### Operations
```js
new Decimal('0.1').plus(new Decimal('0.2')).valueOf(); // => 0.1 + 0.3
new Decimal('0.3').minus(new Decimal('0.1')).valueOf(); // => 0.3 - 0.1
new Decimal('0.6').times(new Decimal('3')).valueOf(); // => 0.6 * 3
new Decimal('0.3').div(new Decimal('0.2')).valueOf(); // => 0.3 / 0.2
new Decimal('2').pow(new Decimal('3')).valueOf(); // => 8
new Decimal('9').sqrt().valueOf(); // => 3
new Decimal('2').equals(new Decimal('2')); // => true
new Decimal('2').equals(new Decimal('3')); // => false
new Decimal('2').lt(new Decimal('3')); // => true (other: lte, gt, gte)
new Decimal('2').cmp(new Decimal('3')); // => -1
```
### toString, valueOf and toJSON
```js
var decimalThird = new Decimal('1').div(new Decimal('3'));
// with bigjs-adapter (other adapters might have differing implementations)
decimalThird.toString() === decimalThird.valueOf() === decimalThird.toJSON(); // => true
Number(decimalThird); // => 1/3
```
### JSON.stringify and JSON.parse with reviver
```js
var Decimal40 = decimalFactory(adapter);
Decimal40.setPrecision(40);
var decimalThird = new Decimal40('1').div(new Decimal('3'));
var stringified = JSON.stringify(decimalThird);
// => '"0.3333333333333333333333333333333333333333"'
JSON.parse(stringified, Decimal40.reviver);
// => new Decimal40('0.3333333333333333333333333333333333333333')
```
See [spec](test/spec.js).