# cimagf, cimag, cimagl

> C++ Atlas: `cppatlas.com/w/c/numeric/complex/cimag` | Source: https://en.cppreference.com/w/c/numeric/complex/cimag | Domain: Numerics | Standards: C99

The imaginary part of z.

## Official Specification Summary (cppreference)

```cpp
// Defined in header <complex.h>
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 <tgmath.h>
#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

```c
#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:

```text
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

- [`creal`](https://en.cppreference.com/w/c/numeric/complex/creal) (C99), [`crealf`](https://en.cppreference.com/w/c/numeric/complex/creal) (C99), [`creall`](https://en.cppreference.com/w/c/numeric/complex/creal) (C99): computes the real part of a complex number (function)
- [C++ documentation for `imag`](https://en.cppreference.com/w/cpp/numeric/complex/imag2)

---
Attribution: content from https://en.cppreference.com/w/c/numeric/complex/cimag (cppreference.com), licensed under CC-BY-SA 3.0 and GFDL. Modified: converted to markdown, study notes added. Offline snapshot of 9 February 2025.