ОБЗОР

#include <complex.h>

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

Компонуется при указании параметра -lm.

ОПИСАНИЕ

Эти функции вычисляют комплексный аргумент (так называемый фазовый угол) z с обрезанием ветви вдоль отрицательной действительной оси.

Комплексное число может быть описано двумя действительными координатами. Для этого можно использовать прямоугольные координаты и получить

    z = x + I * y

где x = creal(z) и y = cimag(z).

Также можно использовать полярные координаты и получить

    z = r * cexp(I * a)

где r = cabs(z) — «радиус», «модуль» или абсолютное значение z, и a = carg(z) — «фазовый угол», или аргумент z.

Формула вычисления:

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

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ

Возвращаемое значение лежит в диапазоне [-pi,pi].

ВЕРСИИ

Эти функции впервые появились в glibc 2.1.

АТРИБУТЫ

Описание терминов данного раздела смотрите в attributes(7).

Интерфейс	Атрибут	Значение
carg(), cargf(), cargl()	безвредность в нитях	безвредно (MT-Safe)

СООТВЕТСТВИЕ СТАНДАРТАМ

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