ИМЯ

carg, cargf, cargl - вычисляет комплексный аргумент

ОБЗОР

#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.