carg(3) berechnet den Phasenwinkel einer komplexen Zahl

Other Alias

cargf, cargl

ÜBERSICHT

#include <complex.h>

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

Linken Sie mit der Option -lm.

BESCHREIBUNG

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

Eine komplexe Zahl kann durch zwei reelle Koordinaten beschrieben werden. Man kann sie in rechtwinkligen Koordinaten ausdrücken als

    z = x + I * y

mit x = creal(z) und y = cimag(z).

Die Beschreibung in Polarkoordinaten ist

    z = r * cexp(I * a)
Darin ist r = cabs(z) der »Radius«, der »Betrag«, der Absolutwert von z und a = carg(z) ist der »Phasenwinkel«, das Argument von z.

Es gilt:

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

RÜCKGABEWERT

Der Rückgabewert liegt im Intervall [-Pi,Pi].

VERSIONEN

Diese Funktionen kamen erstmals in Glibc 2.1 vor.

ATTRIBUTE

Siehe attributes(7) für eine Erläuterung der in diesem Abschnitt verwandten Ausdrücke.
SchnittstelleAttributWert
carg(), cargf(), cargl() Multithread-FähigkeitMT-Safe

KONFORM ZU

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

KOLOPHON

Diese Seite ist Teil der Veröffentlichung 4.06 des Projekts Linux-man-pages. Eine Beschreibung des Projekts, Informationen, wie Fehler gemeldet werden können sowie die aktuelle Version dieser Seite finden sich unter https://www.kernel.org/doc/man-pages/.

ÜBERSETZUNG

Die deutsche Übersetzung dieser Handbuchseite wurde von Martin Eberhard Schauer <[email protected]> erstellt.

Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.

Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an <[email protected]>.