cppreference.com

Log in

Namespaces

Variants

Views

Actions

cimagf, cimag, cimagl

From cppreference.com

< c‎ | numeric‎ | complex

Compiler support

Program utilities

Variadic function support

Dynamic memory management

Strings library

Date and time utilities

Input/output support

Localization support

Concurrency support (C11)

Technical Specifications

Common mathematical functions

Floating-point environment (C99)

Pseudo-random number generation

Complex number arithmetic (C99)

Type-generic math (C99)

Bit manipulation (C23)

Checked integer arithmetic (C23)

Complex number arithmetic

Types and the imaginary constant

(C99)

(C99)

(C11)

(C99)

(C99)

I

(C99)

Manipulation

cimag

(C99)

(C99)

(C99)

(C99)

(C99)

(C99)

Power and exponential functions

(C99)

(C99)

(C99)

(C99)

Trigonometric functions

(C99)

(C99)

(C99)

(C99)

(C99)

(C99)

Hyperbolic functions

(C99)

(C99)

(C99)

(C99)

(C99)

(C99)

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.

Contents

1 Parameters
2 Return value
3 Notes
4 Example
5 References
6 See also

[edit] Parameters

z - complex argument

[edit] 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

[edit] Notes

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

[edit] Example

Run this code

#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

[edit] 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)

[edit] See also

crealcrealfcreall

(C99)(C99)(C99)

computes the real part of a complex number
(function) [edit]

C++ documentation for imag

Retrieved from "https://en.cppreference.com/mwiki/index.php?title=c/numeric/complex/cimag&oldid=77458"