# conj
> Return the [complex conjugate][complex-conjugate] of a single-precision complex floating-point number.
## Usage
```javascript
var conj = require( '@stdlib/complex/float32/conj' );
```
#### conj( z )
Returns the [complex conjugate][complex-conjugate] of a single-precision complex floating-point number.
```javascript
var Complex64 = require( '@stdlib/complex/float32/ctor' );
var z = new Complex64( 5.0, 3.0 );
var str = z.toString();
// returns '5 + 3i'
var v = conj( z );
str = v.toString();
// returns '5 - 3i'
```
## Examples
```javascript
var Complex64 = require( '@stdlib/complex/float32/ctor' );
var discreteUniform = require( '@stdlib/random/base/discrete-uniform' );
var filledarrayBy = require( '@stdlib/array/filled-by' );
var conj = require( '@stdlib/complex/float32/conj' );
function random() {
return new Complex64( discreteUniform( -10, 10 ), discreteUniform( -10, 10 ) );
}
// Generate an array of random complex numbers:
var x = filledarrayBy( 100, 'complex64', random );
// returns
// Compute the complex conjugate of each complex number...
var z;
var i;
for ( i = 0; i < 100; i++ ) {
z = x.get( i );
console.log( 'conj(%s) = %s', z.toString(), conj( z ).toString() );
}
```
* * *
## C APIs
### Usage
```c
#include "stdlib/complex/float32/conj.h"
```
#### stdlib_complex64_conj( z )
Returns the [complex conjugate][complex-conjugate] of a single-precision complex floating-point number.
```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( 5.0f, 2.0f );
// ...
stdlib_complex64_t v = stdlib_complex64_conj( z );
float re = stdlib_complex64_real( v );
// returns 5.0f
float im = stdlib_complex64_imag( v );
// returns -2.0f
```
The function accepts the following arguments:
- **z**: `[in] stdlib_complex64_t` single-precision complex floating-point number.
```c
stdlib_complex64_t stdlib_complex64_conj( const stdlib_complex64_t z );
```
### Examples
```c
#include "stdlib/complex/float32/conj.h"
#include "stdlib/complex/float32/real.h"
#include "stdlib/complex/float32/imag.h"
#include "stdlib/complex/float32/ctor.h"
#include
int main( void ) {
const stdlib_complex64_t x[] = {
stdlib_complex64( 5.0f, 2.0f ),
stdlib_complex64( -2.0f, 1.0f ),
stdlib_complex64( 0.0f, -0.0f ),
stdlib_complex64( 0.0f/0.0f, 0.0f/0.0f )
};
stdlib_complex64_t z;
stdlib_complex64_t v;
int i;
for ( i = 0; i < 4; i++ ) {
z = x[ i ];
v = stdlib_complex64_conj( z );
printf( "conj(%f + %fi) = %f + %fi\n", stdlib_complex64_real( z ), stdlib_complex64_imag( z ), stdlib_complex64_real( v ), stdlib_complex64_imag( v ) );
}
}
```
[complex-conjugate]: https://en.wikipedia.org/wiki/Complex_conjugate
[@stdlib/complex/float64/conj]: https://github.com/stdlib-js/complex/tree/main/float64/conj
[@stdlib/complex/float32/imag]: https://github.com/stdlib-js/complex/tree/main/float32/imag
[@stdlib/complex/float32/real]: https://github.com/stdlib-js/complex/tree/main/float32/real
[@stdlib/complex/float32/reim]: https://github.com/stdlib-js/complex/tree/main/float32/reim