History

NunoSempere b6addc7f05 feat: add the node modules Necessary in order to clearly see the squiggle hotwiring.		2022-12-03 12:44:49 +00:00
..
docs	feat: add the node modules	2022-12-03 12:44:49 +00:00
lib	feat: add the node modules	2022-12-03 12:44:49 +00:00
package.json	feat: add the node modules	2022-12-03 12:44:49 +00:00
README.md	feat: add the node modules	2022-12-03 12:44:49 +00:00

README.md

isSafeInteger

Test if a finite double-precision floating-point number is a safe integer.

Usage

var isSafeInteger = require( '@stdlib/math/base/assert/is-safe-integer' );

isSafeInteger( x )

Tests if a finite double-precision floating-point number is a safe integer.

var bool = isSafeInteger( 1.0 );
// returns true

Notes

An integer valued number is "safe" when the number can be exactly represented as a double-precision floating-point number. For example,
```
var MAX_SAFE_INTEGER = require( '@stdlib/constants/float64/max-safe-integer' );
// returns 9007199254740991

var x = 9007199254740992;
// returns 9007199254740992

var y = 9007199254740993;
// returns 9007199254740992

var bool = ( x === y );
// returns true
```
In this example, x and y should be distinct, but they are not due to constraints imposed by storing numeric values in double-precision floating-point format. "Safe" integers are thus double-precision floating-point numbers having integer values with unequivocal binary representations.

Examples

var isSafeInteger = require( '@stdlib/math/base/assert/is-safe-integer' );

var bool = isSafeInteger( -5.0 );
// returns true

bool = isSafeInteger( 2.0e200 );
// returns false

bool = isSafeInteger( 3.14 );
// returns false

bool = isSafeInteger( NaN );
// returns false