# isSameValue
> Test whether two double-precision complex floating-point numbers are the same value.
## Usage
```javascript
var isSameValue = require( '@stdlib/complex/float64/base/assert/is-same-value' );
```
#### isSameValue( z1, z2 )
Tests whether two double-precision complex floating-point numbers are the same value.
```javascript
var Complex128 = require( '@stdlib/complex/float64/ctor' );
var z1 = new Complex128( 5.0, 3.0 );
var z2 = new Complex128( 5.0, 3.0 );
var out = isSameValue( z1, z2 );
// returns true
```
In contrast to the strict equality operator `===`, the function distinguishes between `+0` and `-0` and treats `NaNs` as the same value.
```javascript
var Complex128 = require( '@stdlib/complex/float64/ctor' );
var z1 = new Complex128( NaN, NaN );
var z2 = new Complex128( NaN, NaN );
var out = isSameValue( z1, z2 );
// returns true
z1 = new Complex128( -0.0, 0.0 );
z2 = new Complex128( 0.0, -0.0 );
out = isSameValue( z1, z2 );
// returns false
```
## Notes
- The function implements the [SameValue Algorithm][ecma-262-same-value-algorithm] as specified in ECMAScript 5.
## Examples
```javascript
var Complex128 = require( '@stdlib/complex/float64/ctor' );
var isSameValue = require( '@stdlib/complex/float64/base/assert/is-same-value' );
var z1 = new Complex128( 5.0, 3.0 );
var z2 = new Complex128( 5.0, 3.0 );
var out = isSameValue( z1, z2 );
// returns true
z1 = new Complex128( -5.0, -3.0 );
z2 = new Complex128( 5.0, 3.0 );
out = isSameValue( z1, z2 );
// returns false
z1 = new Complex128( NaN, 3.0 );
z2 = new Complex128( NaN, 3.0 );
out = isSameValue( z1, z2 );
// returns true
```
* * *
## C APIs
### Usage
```c
#include "stdlib/complex/float64/base/assert/is_same_value.h"
```
#### stdlib_base_complex128_is_same_value( z1, z2 )
Tests whether two double-precision complex floating-point numbers are the same value.
```c
#include "stdlib/complex/float64/ctor.h"
#include
stdlib_complex128_t z1 = stdlib_complex128( 5.0, 2.0 );
stdlib_complex128_t z2 = stdlib_complex128( 5.0, 2.0 );
bool v = stdlib_base_complex128_is_same_value( z1, z2 );
```
The function accepts the following arguments:
- **z1**: `[in] stdlib_complex128_t` first double-precision complex floating-point number.
- **z2**: `[in] stdlib_complex128_t` second double-precision complex floating-point number.
```c
bool stdlib_base_complex128_is_same_value( const stdlib_complex128_t z1, const stdlib_complex128_t z2 );
```
### Examples
```c
#include "stdlib/complex/float64/base/assert/is_same_value.h"
#include "stdlib/complex/float64/ctor.h"
#include
#include
int main( void ) {
const stdlib_complex128_t z[] = {
stdlib_complex128( 5.0, 2.0 ),
stdlib_complex128( -2.0, 1.0 ),
stdlib_complex128( 0.0, -0.0 ),
stdlib_complex128( 0.0/0.0, 0.0/0.0 )
};
bool v;
int i;
for ( i = 0; i < 4; i++ ) {
v = stdlib_base_complex128_is_same_value( z[ i ], z[ i ] );
printf( "Same value? %s\n", ( v ) ? "True" : "False" );
}
}
```
[ecma-262-same-value-algorithm]: http://ecma-international.org/ecma-262/5.1/#sec-9.12