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

VERSIONEN

       Diese Funktionen wurden in Glibc 2.1 hinzugefügt.

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-Safe │
       └───────────────────────────────────────────────────────┴───────────────────────┴─────────┘

STANDARDS

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

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 ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ 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 ⟨debian-l10n-german@lists.debian.org⟩.