carg, cargf, cargl

Ruft das Argument einer komplexen Zahl mit einem Achsenabschnitt auf der negativen reellen Achse ab.

Syntax

double carg(
   _Dcomplex z
);
float carg(
   _Fcomplex z
);  // C++ only
long double carg(
   _Lcomplex z
);  // C++ only
float cargf(
   _Fcomplex z
);
long double cargl(
   _Lcomplex z
);
#define carg(X) // Requires C11 or higher

Parameter

z
Eine komplexe Zahl.

Rückgabewert

Das Argument (auch als Phase bezeichnet) von z. Das Ergebnis liegt im Intervall [-π, +π].

Hinweise

Da C++ das Überladen zulässt, können Sie Überladungen von carg aufrufen, die _Fcomplex- oder _Lcomplex-Werte annehmen und float- oder long double-Werte zurückgeben. In einem C-Programm wird immer ein Wert verwendet, es sei denn, Sie verwenden das <Makro tgmath.h> , um diese Funktion aufzurufen, carg verwendet immer einen _Dcomplex Wert und gibt einen double Wert zurück.

Wenn Sie das <Makro tgmath.h>carg() verwenden, bestimmt der Typ des Arguments, welche Version der Funktion ausgewählt ist. Ausführliche Informationen finden Sie unter "Typgenerika" .

Anforderungen

Routine	C-Header	C++-Header
carg, cargf, cargl	<complex.h>	<ccomplex>
carg-Makro	<tgmath.h>

Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.

Siehe auch

Alphabetische Funktionsreferenz
norm, normf, norml
creal, crealf, creall
cproj, cprojf, cprojl
conj, conjf, conjl
cimag, cimagf, cimagl
cabs, cabsf, cabsl