Normalize
Returns a normal number
y
and exponentexp
satisfyingx = y * 2^exp
.
Installation
$ npm install math-float32-normalize
Usage
var normalize = ;
normalize( x )
Returns a normal number y
and exponent exp
satisfying x = y * 2^exp
.
var toFloat32 = ;var out = ;// returns [ 1.1754943508222875e-38, -23 ]
The first element of the returned array
corresponds to y
and the second to exp
.
var pow = ;var y = out 0 ;var exp = out 1 ;var bool = y* === ;// returns true
The function
expects a finite, non-zero single-precision floating-point number x
. If x == 0
,
var out = ;// returns [ 0, 0 ];
If x
is either positive or negative infinity
or NaN
,
var pinf = ;var ninf = ;var out = ;// returns [ pinf, 0 ]out = ;// returns [ ninf, 0 ]out = ;// returns [ NaN, 0 ]
Notes
- While the
function
accepts higher precision floating-point numbers, beware that providing such numbers can be a source of subtle bugs as the relationx = y * 2^exp
may not hold.
Examples
var round = ;var pow = ;var toFloat32 = ;var normalize = ;var frac;var exp;var x;var v;var i;// Generate denormalized single-precision floating-point numbers and then normalize them...for i = 0; i < 100; i++frac = Math * 10;exp = 38 + ;x = frac * ;x = ;v = ;console;
To run the example code from the top-level application directory,
$ node ./examples/index.js
Tests
Unit
This repository uses tape for unit tests. To run the tests, execute the following command in the top-level application directory:
$ make test
All new feature development should have corresponding unit tests to validate correct functionality.
Test Coverage
This repository uses Istanbul as its code coverage tool. To generate a test coverage report, execute the following command in the top-level application directory:
$ make test-cov
Istanbul creates a ./reports/coverage
directory. To access an HTML version of the report,
$ make view-cov
Browser Support
This repository uses Testling for browser testing. To run the tests in a (headless) local web browser, execute the following command in the top-level application directory:
$ make test-browsers
To view the tests in a local web browser,
$ make view-browser-tests
License
Copyright
Copyright © 2016. The Compute.io Authors.