isSameValueZerof
Test if two single-precision floating-point numbers are the same value.
Usage
var isSameValueZerof = require( '@stdlib/number/float32/base/assert/is-same-value-zero' );
isSameValueZerof( a, b )
Tests if two single-precision floating-point numbers a
and b
are the same value.
var toFloat32 = require( '@stdlib/number/float64/base/to-float32' );
var bool = isSameValueZerof( toFloat32( 3.14 ), toFloat32( 3.14 ) );
// returns true
bool = isSameValueZerof( toFloat32( 5.0 ), toFloat32( 3.0 ) );
// returns false
In contrast to the strict equality operator ===
, the function treats NaNs
as the same value.
var bool = ( NaN === NaN );
// returns false
bool = isSameValueZerof( NaN, NaN );
// returns true
In contrast to the SameValue Algorithm (as specified in ECMAScript 5), the function does not distinguish between +0
and -0
.
var bool = ( 0.0 === -0.0 );
// returns true
bool = isSameValueZerof( 0.0, -0.0 );
// returns true
bool = isSameValueZerof( -0.0, 0.0 );
// returns true
Examples
var toFloat32 = require( '@stdlib/number/float64/base/to-float32' );
var isSameValueZerof = require( '@stdlib/number/float32/base/assert/is-same-value-zero' );
var bool = isSameValueZerof( toFloat32( 3.14 ), toFloat32( 3.14 ) );
// returns true
bool = isSameValueZerof( toFloat32( 0.0 ), toFloat32( 0.0 ) );
// returns true
bool = isSameValueZerof( toFloat32( -0.0 ), toFloat32( 0.0 ) );
// returns true
bool = isSameValueZerof( toFloat32( NaN ), toFloat32( NaN ) );
// returns true
C APIs
Usage
#include "stdlib/number/float32/base/assert/is_same_value_zero.h"
stdlib_base_float32_is_same_value_zero( a, b )
Tests if two single-precision floating-point numbers a
and b
are the same value.
#include <stdbool.h>
bool v = stdlib_base_float32_is_same_value_zero( 3.14f, 3.14f );
// returns true
v = stdlib_base_float32_is_same_value_zero( 0.0f, -0.0f );
// returns true
The function accepts the following arguments:
- a:
[in] float
first input value. - b:
[in] float
second input value.
bool stdlib_base_float32_is_same_value_zero( const float a, const float b );
Examples
#include "stdlib/number/float32/base/assert/is_same_value_zero.h"
#include <stdbool.h>
#include <stdio.h>
int main( void ) {
const float a[] = {
5.0f,
-2.0f,
0.0f,
0.0f/0.0f
};
const float b[] = {
5.0f,
2.0f,
-0.0f,
0.0f/0.0f
};
bool v;
int i;
for ( i = 0; i < 4; i++ ) {
v = stdlib_base_float32_is_same_value_zero( a[ i ], b[ i ] );
printf( "Same value? %s\n", ( v ) ? "True" : "False" );
}
}