NAME

SYNOPSIS

DESCRIPTION

RETURN VALUE

VERSIONS

ATTRIBUTES

CONFORMING TO

SEE ALSO

COLOPHON

## NAME

## SYNOPSIS

## DESCRIPTION

## RETURN VALUE

## VERSIONS

## ATTRIBUTES

## CONFORMING TO

## SEE ALSO

## COLOPHON

SYNOPSIS

DESCRIPTION

RETURN VALUE

VERSIONS

ATTRIBUTES

CONFORMING TO

SEE ALSO

COLOPHON

carg, cargf, cargl − calculate the complex argument

**#include
<complex.h>**

**double
carg(double complex** *z***);
float cargf(float complex**

long double cargl(long double complex

Link with
*−lm*.

These functions
calculate the complex argument (also called phase angle) of
*z*, with a branch cut along the negative real
axis.

A complex number can be described by two real coordinates. One may use rectangular coordinates and gets

z = x + I * y

where
*x = creal(z)* and
*y = cimag(z)*.

Or one may use polar coordinates and gets

z = r * cexp(I * a)

where
*r = cabs(z)* is the "radius", the
"modulus", the absolute value of *z*, and
*a = carg(z)* is the "phase angle",
the argument of *z*.

One has:

tan(carg(z)) = cimag(z) / creal(z)

The return value is the range of [−pi,pi].

These functions first appeared in glibc in version 2.1.

For an
explanation of the terms used in this section, see
**attributes**(7).

C99, POSIX.1-2001, POSIX.1-2008.

**cabs**(3),
**complex**(7)

This page is
part of release 4.04 of the Linux *man-pages* project.
A description of the project, information about reporting
bugs, and the latest version of this page, can be found at
http://www.kernel.org/doc/man−pages/.

© 2018-2020 SourceBinary.com Inc.

Microsoft Windows, XP, Vista are registered trademarks of Microsoft Corporation