BEZEICHNUNG

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

Ü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.
       ┌──────────────────────────┬───────────────────────┬─────────┐
       │ Schnittstelle            │ Attribut              │ Wert    │
       ├──────────────────────────┼───────────────────────┼─────────┤
       │ carg(), cargf(), cargl() │ Multithread-Fähigkeit │ MT-Safe │
       └──────────────────────────┴───────────────────────┴─────────┘

KONFORM ZU

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

SIEHE AUCH

       cabs(3), complex(7)

KOLOPHON

       Diese Seite ist Teil der Veröffentlichung  4.04  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 http://www.kernel.org/doc/man-pages/.

ÜBERSETZUNG

       Die deutsche Übersetzung dieser Handbuchseite wurde von Martin Eberhard Schauer <Martin.E.Schauer@gmx.de>
       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
       <debian-l10n-german@lists.debian.org>.

                                                 19. April 2015                                          CARG(3)