Absolute Value

Compute an absolute value.

The absolute value is defined as

StartAbsoluteValue x EndAbsoluteValue equals StartLayout Enlarged left-brace 1st Row 1st Column x 2nd Column if x greater-than-or-equal-to 0 2nd Row 1st Column negative x 2nd Column if x less-than 0 EndLayout

Usage

var abs = require( '@stdlib/fastmath/special/abs' );

abs( x )

Computes an absolute value.

var v = abs( -1.0 );
// returns 1.0

v = abs( 2.0 );
// returns 2.0

v = abs( 0.0 );
// returns 0.0

v = abs( NaN );
// returns NaN

Notes

  • This implementation is not IEEE 754 compliant. If provided -0, the function returns -0.

    var v = abs( -0.0 );
    // returns -0.0
    

Examples

var randu = require( '@stdlib/random/base/randu' );
var round = require( '@stdlib/math/base/special/round' );
var abs = require( '@stdlib/fastmath/special/abs' );

var rand;
var i;

for ( i = 0; i < 100; i++ ) {
    rand = round( randu() * 100.0 ) - 50.0;
    console.log( 'abs(%d) = %d', rand, abs( rand ) );
}