cimagf, cimag, cimagl

< c‎ | numeric‎ | complex

C
 Language headers Type support Dynamic memory management Error handling Program utilities Variadic function support Date and time utilities Strings library Algorithms Numerics Input/output support Localization support Thread support (C11) Atomic operations (C11) Technical Specifications

Complex number arithmetic
Types and the imaginary constant
Manipulation
 cimag creal carg
Power and exponential functions
Trigonometric functions
Hyperbolic functions

 Defined in header `` float       cimagf( float complex z ); (1) (since C99) double      cimag( double complex z ); (2) (since C99) long double cimagl( long double complex z ); (3) (since C99) Defined in header `` #define cimag( z ) (4) (since C99)
1-3) Returns the imaginary part of `z`.
4) Type-generic macro: if `z` has type long double complex, long double imaginary, or long double, `cimagl` is called. If `z` has type float complex, float imaginary, or float, `cimagf` is called. If `z` has type double complex, double imaginary, double, or any integer type, `cimag` is called.

Parameters

 z - complex argument

Return value

The imaginary part of `z`.

This function is fully specified for all possible inputs and is not subject to any errors described in math_errhandling

Notes

For any complex variable `z`, z == creal(z) + I*cimag(z).

Example

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

int main(void)
{
double complex z = 1.0 + 2.0*I;
printf("%f%+fi\n", creal(z), cimag(z));
}```

Output:

`1.000000+2.000000i`

References

• C11 standard (ISO/IEC 9899:2011):
• 7.3.9.2 The cimag functions (p: 197)
• 7.25 Type-generic math <tgmath.h> (p: 373-375)
• G.7 Type-generic math <tgmath.h> (p: 545)
• C99 standard (ISO/IEC 9899:1999):
• 7.3.9.2 The cimag functions (p: 178-179)
• 7.22 Type-generic math <tgmath.h> (p: 335-337)
• G.7 Type-generic math <tgmath.h> (p: 480)

See also

 crealcrealfcreall(C99)(C99)(C99) computes the real part of a complex number (function) C++ documentation for imag