CARG 3CW "21 March 2008" "mathcw-1.00"

Table of contents


NAME

cargf, carg, cargl, cargw, cargq, cargll, cargdf, cargd, cargdl, cargdll - complex argument function

SYNOPSIS

cc [ flags ] -I/usr/local/include file(s) -L/usr/local/lib -lmcw [ ... ]

#include <mathcw.h>

#include <complexcw.h>

extern float cargf (float complex z);

extern double carg (double complex z);

extern long double cargl (long double complex z);

extern __float80 cargw (__float80 complex z);

extern __float128 cargq (__float128 complex z);

extern long_long_double cargll (long_long_double complex z);

extern decimal_float cargdf (decimal_float complex z);

extern decimal_double cargd (decimal_double complex z);

extern decimal_long_double cargdl (decimal_long_double complex z);

extern decimal_long_long_double cargdll (decimal_long_long_double complex z);

NB: Functions with prototypes containing underscores in type names may be available only with certain extended compilers.


DESCRIPTION

Compute the argument (angle in radians, sometimes called the phase) of the complex value z.

If the argument in Cartesian form is z = x + y I, where x and y are real, then in polar form, z = r exp(t I), where r = |z| = cabs(z) = hypot(x, y) and t = carg(z) = atan2(y, x).

When compiler support for complex types is lacking, consider using the cx family of functions instead.


RETURN VALUES

Return the argument (angle in radians).

ERRORS

If either component of the argument is a NaN, return the argument without setting errno.

SEE ALSO

cabs(3CW), cadd(3CW), ccopy(3CW), cdiv(3CW), cimag(3CW), cmul(3CW), cneg(3CW), conj(3CW), cproj(3CW), creal(3CW), cset(3CW), csub(3CW).