carg(), cargf(), cargl()

Compute the argument of a complex number

Synopsis:

#include <complex.h>

double carg(double complex z);

float cargf(float complex z);

long double cargl(long double complex z);

Arguments:

z
The complex value that you want to get the argument of.

Library:

libm

Use the -l m option to qcc to link against this library.

Description:

These functions compute the argument (or phase angle) of the complex number specified by z, with a branch cut along the negative real axis.

To check for error situations, use feclearexcept() and fetestexcept(). For example:

Returns:

If no errors occur, the argument of z, in the interval (-π; π).

Errors and special cases are handled as if the function were implemented as atan2 (cimag(z), creal(z)).

These functions raise FE_INEXACT if the FPU reports that the result can't be exactly represented as a floating-point number.

Classification:

ANSI, POSIX 1003.1

Safety:  
Cancellation point No
Interrupt handler No
Signal handler No
Thread Yes