CMPLXF, CMPLX, CMPLXL - cppreference.com

##### cppreference.com

##### Search

Create account

##### Namespaces

- Page
- Discussion

##### Variants

##### Views

- View
- Edit
- History

##### Actions

# CMPLXF, CMPLX, CMPLXL

From cppreference.com
< c‎ | numeric‎ | complex

Defined in header `<complex.h>` |  |
float complex CMPLXF( float real, float imag ); |  | (since C11)
double complex CMPLX( double real, double imag ); |  | (since C11)
long double complex CMPLXL( long double real, long double imag ); |  | (since C11)

Each of these macros expands to an expression that evaluates to the value of the specified complex type, with the real part having the value of `real` (converted to the specified argument type) and the imaginary part having the value of `imag` (converted to the specified argument type)

The expressions are suitable for use as initializers for objects with static or thread storage duration, as long as the expressions `real` and `imag` are also suitable.

### [edit] Parameters

real | - | the real part of the complex number to return
imag | - | the imaginary part of the complex number to return

### [edit] Return value

A complex number composed of `real` and `imag` as the real and imaginary parts.

### [edit] Notes

These macros are implemented as if the imaginary types are supported (even if they are otherwise not supported and _Imaginary_I is actually undefined) and as if defined as follows:

    #define CMPLX(x, y) ((double complex)((double)(x) + _Imaginary_I * (double)(y)))
    #define CMPLXF(x, y) ((float complex)((float)(x) + _Imaginary_I * (float)(y)))
    #define CMPLXL(x, y) ((long double complex)((long double)(x) + \
                          _Imaginary_I * (long double)(y)))

### [edit] Example

Run this code

    #include <stdio.h>
    #include <complex.h>

    int main(void)
    {
        double complex z = CMPLX(0.0, -0.0);
        printf("z = %.1f%+.1fi\n", creal(z), cimag(z));
    }

Output:

    z = 0.0-0.0i

### [edit] References

- C11 standard (ISO/IEC 9899:2011):

  - 7.3.9.3 The CMPLX macros (p: 197)

### [edit] See also

_Imaginary_I (C99) | the imaginary unit constant i (macro constant) [edit]
C++ documentation for complex

Retrieved from "http://en.cppreference.com/mwiki/index.php?title=c/numeric/complex/CMPLX&oldid=77485"