carg(), cargf(), cargl() — Calculate the argument

Standards

Standards / Extensions	C or C++	Dependencies
C99 Single UNIX Specification, Version 3	both	z/OS V1R7 a compiler that is designed to support C99

Format

#include <complex.h>

double carg(double complex z);
float cargf(float complex z);
long double cargl(long double complex z);

General description

The carg() family of functions compute the argument (phase angle) of z, with a branch cut along the negative real axis.

Note: The following table shows the viable formats for these functions. See IEEE binary floating-point for more information about IEEE Binary Floating-Point.

Function	Hex	IEEE
carg	X	X
cargf	X	X
cargl	X	X

Returned value

The carg() family of functions return the value of the argument in the interval [-π, +π].

Example

For an example of a similar function see cacos(), cexp() or cpow().

Related information

complex.h
creal(), crealf(), creall() — Calculate the complex real part
cimag(), cimagf(), cimagl() — Calculate the complex imaginary part
conj(), conjf(), conjl() — Calculate the complex conjugate
cproj(), cprojf(), cprojl() — Calculate the projection