# add
> Add two single-precision complex floating-point numbers.
## Usage
```javascript
var add = require( '@stdlib/complex/float32/base/add' );
```
#### add( z1, z2 )
Adds two single-precision complex floating-point numbers.
```javascript
var Complex64 = require( '@stdlib/complex/float32/ctor' );
var realf = require( '@stdlib/complex/float32/real' );
var imagf = require( '@stdlib/complex/float32/imag' );
var z = new Complex64( -1.5, 2.5 );
var v = add( z, z );
// returns
var re = realf( v );
// returns -3.0
var im = imagf( v );
// returns 5.0
```
## Examples
```javascript
var Complex64 = require( '@stdlib/complex/float32/ctor' );
var discreteUniform = require( '@stdlib/random/base/discrete-uniform' ).factory;
var add = require( '@stdlib/complex/float32/base/add' );
var rand = discreteUniform( -50, 50 );
var z1;
var z2;
var z3;
var i;
for ( i = 0; i < 100; i++ ) {
z1 = new Complex64( rand(), rand() );
z2 = new Complex64( rand(), rand() );
z3 = add( z1, z2 );
console.log( '(%s) + (%s) = %s', z1.toString(), z2.toString(), z3.toString() );
}
```
* * *
## C APIs
### Usage
```c
#include "stdlib/complex/float32/base/add.h"
```
#### stdlib_base_complex64_add( z1, z2 )
Adds two single-precision complex floating-point numbers.
```c
#include "stdlib/complex/float32/ctor.h"
#include "stdlib/complex/float32/real.h"
#include "stdlib/complex/float32/imag.h"
stdlib_complex64_t z = stdlib_complex64( 3.0f, -2.0f );
stdlib_complex64_t out = stdlib_base_complex64_add( z, z );
float re = stdlib_complex64_real( out );
// returns 6.0f
float im = stdlib_complex64_imag( out );
// returns -4.0f
```
The function accepts the following arguments:
- **z1**: `[in] stdlib_complex64_t` input value.
- **z2**: `[in] stdlib_complex64_t` input value.
```c
stdlib_complex64_t stdlib_base_complex64_add( const stdlib_complex64_t z1, const stdlib_complex64_t z2 );
```
### Examples
```c
#include "stdlib/complex/float32/base/add.h"
#include "stdlib/complex/float32/ctor.h"
#include "stdlib/complex/float32/reim.h"
#include
int main( void ) {
const stdlib_complex64_t x[] = {
stdlib_complex64( 3.14f, 1.5f ),
stdlib_complex64( -3.14f, 1.5f ),
stdlib_complex64( 0.0f, -0.0f ),
stdlib_complex64( 0.0f/0.0f, 0.0f/0.0f )
};
stdlib_complex64_t v;
stdlib_complex64_t y;
float re;
float im;
int i;
for ( i = 0; i < 4; i++ ) {
v = x[ i ];
stdlib_complex64_reim( v, &re, &im );
printf( "z = %f + %fi\n", re, im );
y = stdlib_base_complex64_add( v, v );
stdlib_complex64_reim( y, &re, &im );
printf( "add(z, z) = %f + %fi\n", re, im );
}
}
```
[@stdlib/complex/float64/base/add]: https://github.com/stdlib-js/complex/tree/main/float64/base/add
[@stdlib/complex/float32/base/mul]: https://github.com/stdlib-js/complex/tree/main/float32/base/mul
[@stdlib/math/base/ops/csubf]: https://www.npmjs.com/package/@stdlib/math-base-ops-csubf