Operations on Complex (The GNU C Library)

### 20.10 Projections, Conjugates, and Decomposing of Complex Numbers ¶

ISO C99 also defines functions that perform basic operations on complex numbers, such as decomposition and conjugation. The prototypes for all these functions are in `complex.h`. All functions are available in three variants, one for each of the three complex types.

Function: `double` creal `(complex double z)` ¶
Function: `float` crealf `(complex float z)` ¶
Function: `long double` creall `(complex long double z)` ¶
Function: `_FloatN` crealfN `(complex _FloatN z)` ¶
Function: `_FloatNx` crealfNx `(complex _FloatNx z)` ¶

  Preliminary: | MT-Safe | AS-Safe | AC-Safe | See POSIX Safety Concepts.

  These functions return the real part of the complex number z.

Function: `double` cimag `(complex double z)` ¶
Function: `float` cimagf `(complex float z)` ¶
Function: `long double` cimagl `(complex long double z)` ¶
Function: `_FloatN` cimagfN `(complex _FloatN z)` ¶
Function: `_FloatNx` cimagfNx `(complex _FloatNx z)` ¶

  Preliminary: | MT-Safe | AS-Safe | AC-Safe | See POSIX Safety Concepts.

  These functions return the imaginary part of the complex number z.

Function: `complex double` conj `(complex double z)` ¶
Function: `complex float` conjf `(complex float z)` ¶
Function: `complex long double` conjl `(complex long double z)` ¶
Function: `complex _FloatN` conjfN `(complex _FloatN z)` ¶
Function: `complex _FloatNx` conjfNx `(complex _FloatNx z)` ¶

  Preliminary: | MT-Safe | AS-Safe | AC-Safe | See POSIX Safety Concepts.

  These functions return the conjugate value of the complex number z. The conjugate of a complex number has the same real part and a negated imaginary part. In other words, ‘`conj(a + bi) = a + -bi`’.

Function: `double` carg `(complex double z)` ¶
Function: `float` cargf `(complex float z)` ¶
Function: `long double` cargl `(complex long double z)` ¶
Function: `_FloatN` cargfN `(complex _FloatN z)` ¶
Function: `_FloatNx` cargfNx `(complex _FloatNx z)` ¶

  Preliminary: | MT-Safe | AS-Safe | AC-Safe | See POSIX Safety Concepts.

  These functions return the argument of the complex number z. The argument of a complex number is the angle in the complex plane between the positive real axis and a line passing through zero and the number. This angle is measured in the usual fashion and ranges from -π to π.

  `carg` has a branch cut along the negative real axis.

Function: `complex double` cproj `(complex double z)` ¶
Function: `complex float` cprojf `(complex float z)` ¶
Function: `complex long double` cprojl `(complex long double z)` ¶
Function: `complex _FloatN` cprojfN `(complex _FloatN z)` ¶
Function: `complex _FloatNx` cprojfNx `(complex _FloatNx z)` ¶

  Preliminary: | MT-Safe | AS-Safe | AC-Safe | See POSIX Safety Concepts.

  These functions return the projection of the complex value z onto the Riemann sphere. Values with an infinite imaginary part are projected to positive infinity on the real axis, even if the real part is NaN. If the real part is infinite, the result is equivalent to

      INFINITY + I * copysign (0.0, cimag (z))