carg, cargfcargl

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 later

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 Typgengenerische Mathematik.

Anforderungen

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

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

Weitere Informationen

Alphabetische Funktionsreferenz
norm, normfnorml
creal, crealfcreall
cproj, cprojfcprojl
conj, conjfconjl
cimag, cimagfcimagl
cabs, cabsfcabsl