big-rat
Arbitrary precision rational number arithmetic
Example
Program
var rat = require('big-rat')
//Construct a pair of rational numbers;
// a = 1/10
// b = 2/10
var a = rat(1, 10)
var b = rat(2, 10)
//Compute their sum
var add = require('big-rat/add')
var c = add(a, b)
//Print out sum
var toString = require('big-rat/to-string')
console.log('a+b=', toString(c))
//And also convert to a number
var toFloat = require('big-rat/to-float')
console.log('exact rational result:', toFloat(c))
//For comparison, here is the same computation performed with floats
var x = 0.1
var y = 0.2
console.log('approximate float result:', x + y)
Output
a+b= 3/10
exact rational result: 0.3
approximate float result: 0.30000000000000004
Install
npm i big-rat
API
var r = require('big-rat')(n[, d])
Constructs a rational number as the quotient n/d
n
is the numerator. Can be a float, string, bignum or rationald
is the denominator (optional, default1
)
Returns A rational number
var f = require('big-rat/to-float')(r)
Returns The closest floating point number to r
var s = require('big-rat/to-string')(r)
Returns A string representing the big rat r
var b = require('big-rat/is-rat')(r)
Returns true
if r
is a big rat
var c = require('big-rat/add')(a, b)
Returns a+b
var c = require('big-rat/sub')(a, b)
Returns a-b
var c = require('big-rat/mul')(a, b)
Returns a*b
var c = require('big-rat/div')(a, b)
Returns a/b
var c = require('big-rat/neg')(a)
Returns -a
var c = require('big-rat/recip')(a)
Returns 1/a
var c = require('big-rat/sign')(a)
Returns One of the following values:
-1
ifa<0
0
ifa=0
+1
ifa>0
var c = require('big-rat/abs')(a)
Returns |a|
var c = require('big-rat/min')(a, b)
Returns min(a,b)
var c = require('big-rat/max')(a, b)
Returns max(a,b)
var c = require('big-rat/equals')(a, b)
Returns true
if a=b
, false
otherwise
var c = require('big-rat/cmp')(a, b)
Returns
-1
ifa<b
0
ifa=b
+1
ifa>b
License
(c) 2015 MIT License