Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/davidmartinez10/bigfloat
A library for arbitrary precision decimal floating point arithmetic.
https://github.com/davidmartinez10/bigfloat
arbitrary-precision arithmetic bigdecimal bigfloat bigint bignumber business cryptocurrency decimal floating-point math mathematics nodejs physics precision typescript
Last synced: 22 days ago
JSON representation
A library for arbitrary precision decimal floating point arithmetic.
- Host: GitHub
- URL: https://github.com/davidmartinez10/bigfloat
- Owner: davidmartinez10
- License: mit
- Created: 2019-01-31T03:50:27.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2022-03-24T20:19:34.000Z (over 2 years ago)
- Last Synced: 2024-10-31T19:35:54.277Z (about 2 months ago)
- Topics: arbitrary-precision, arithmetic, bigdecimal, bigfloat, bigint, bignumber, business, cryptocurrency, decimal, floating-point, math, mathematics, nodejs, physics, precision, typescript
- Language: TypeScript
- Homepage: https://www.npmjs.com/package/bigfloat.js
- Size: 146 KB
- Stars: 17
- Watchers: 2
- Forks: 1
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://github.com/davidmartinez10/bigfloat)
A library for arbitrary precision decimal floating point arithmetic that can exactly represent all decimal fractions,
unlike JavaScript's number data type which is 64-bit binary floating point.
Based on the original work by Douglas Crockford.
This implementation is built upon the Google Chrome Labs' implementation of ECMAScript big integers: JSBI.
This library provides three ways to make bigfloat operations:
- A set of functions for a functional style approach
- A BigFloat class with an API similar to that of Decimal.js
- An evaluate() function that parses and resolves an expression
NOTE: This is a compatibility package intended for cross-browser support. If you are targetting Node.js, Electron or any engine that supports native bigints and the exponentiation operator(**), then you don't need JSBI and you should be using [bigfloat-esnext](https://github.com/davidmartinez10/bigfloat-esnext).
# Basic usage
### Functional style
```typescript
import { make, string, sqrt } from "bigfloat.js";
string(sqrt(make("2"))); // "1.4142"
```
### Class based
```typescript
import { BigFloat } from "bigfloat.js";
new BigFloat("2").sqrt().toString(); // "1.4142"
```
### The evaluate() function
```typescript
evaluate(expression: string, precision?: number): string | boolean
```
>The first argument can be any valid arithmetic or relational expression, including scientific e-notation.
>(Optional) Precision should be a negative integer. Default is -4.
```typescript
import { evaluate } from "bigfloat.js";
0.1 + 0.2 === 0.3; // false
evaluate("0.1 + 0.2 == 0.3"); // true
0.1 + 0.2; // 0.30000000000000004
evaluate("0.1 + 0.2"); // "0.3"
1 + Number.EPSILON / 2; // 1
evaluate(`1 + ${Number.EPSILON / 2}`); // "1.00000000000000011102230246251565"
evaluate("1 + 2.220446049250313e-16"); // "1.0000000000000002220446049250313"
evaluate(`4 >= ${Math.PI}`); // true
```
Valid tokens:
- Parenthesis: (,)
- Number: Decimal, integer or scientific e-notation
- Operator: Arithmetic +,-,/,\*,\*\* Relational =\=\=,=\=,!==,!=,<,>,<=,>=
### Change precision
```typescript
import { BigFloat, set_precision } from "bigfloat.js";
new BigFloat(2).sqrt().toString(); // "1.4142"
set_precision(-10);
new BigFloat(2).sqrt().toString(); // "1.4142135623"
```
### The bigfloat object
```typescript
interface IBigFloat {
coefficient: JSBI;
exponent: number;
}
```
Valid bigfloat made from primitives:
```typescript
const bigfloat: IBigFloat {
coefficient: JSBI.BigInt(522299),
exponent: -4
};
```