BEZEICHNUNG

       carg, cargf, cargl - berechnet den Phasenwinkel einer komplexen Zahl

BIBLIOTHEK

       Mathematik-Bibliothek (libm, -lm)

ÜBERSICHT

       #include <complex.h>

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

BESCHREIBUNG

       Diese  Funktionen  berechnen  das  komplexe  Argument  (auch  Phasenwinkel  genannt)  von  z,  mit  einem
       Verzweigungsschnitt entlang der negativen reellen Achse.

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

ATTRIBUTE

       Siehe attributes(7) für eine Erläuterung der in diesem Abschnitt verwandten Ausdrücke.
       ┌───────────────────────────────────────────────────────────────────┬───────────────────────┬───────────┐
       │ Schnittstelle                                                     │ Attribut              │ Wert      │
       ├───────────────────────────────────────────────────────────────────┼───────────────────────┼───────────┤
       │ carg(), cargf(), cargl()                                          │ Multithread-Fähigkeit │ MT-Sicher │
       └───────────────────────────────────────────────────────────────────┴───────────────────────┴───────────┘

STANDARDS

       C11, POSIX.1-2008.

GESCHICHTE

       Glibc 2.1. C99, POSIX.1-2001.

SIEHE AUCH

       cabs(3), complex(7)

ÜBERSETZUNG

       Die deutsche Übersetzung dieser Handbuchseite wurde von Martin Eberhard Schauer <Martin.E.Schauer@gmx.de>
       und Dr. Tobias Quathamer <toddy@debian.org> 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 die
       Mailingliste der Übersetzer.

Linux man-pages 6.9.1                              2. Mai 2024                                           carg(3)