.\" -*- coding: UTF-8 -*-
.\" Copyright 2002 Walter Harms (walter.harms@informatik.uni-oldenburg.de)
.\"
.\" %%%LICENSE_START(GPL_NOVERSION_ONELINE)
.\" Distributed under GPL
.\" %%%LICENSE_END
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH CARG 3 "15. September 2017" "" Linux\-Programmierhandbuch
.SH BEZEICHNUNG
carg, cargf, cargl \- berechnet den Phasenwinkel einer komplexen Zahl
.SH ÜBERSICHT
\fB#include <complex.h>\fP
.PP
\fBdouble carg(double complex \fP\fIz\fP\fB);\fP
.br
\fBfloat cargf(float complex \fP\fIz\fP\fB);\fP
.br
\fBlong double cargl(long double complex \fP\fIz\fP\fB);\fP
.PP
Linken Sie mit der Option \fI\-lm\fP.
.SH BESCHREIBUNG
Diese Funktionen berechnen das komplexe Argument (auch Phasenwinkel genannt)
von \fIz\fP, mit einem Verzweigungsschnitt entlang der negativen reellen Achse.
.PP
Eine komplexe Zahl kann durch zwei reelle Koordinaten beschrieben
werden. Man kann sie in rechtwinkligen Koordinaten ausdrücken als
.PP
.nf
    z = x + I * y
.fi
.PP
mit   \fIx\ =\ creal(z)\fP und \fIy\ =\ cimag(z)\fP.
.PP
Die Beschreibung in Polarkoordinaten ist
.PP
.nf
    z = r * cexp(I * a)
.fi
.PP
Darin ist \fIr\ =\ cabs(z)\fP der »Radius«, der »Betrag«, der Absolutwert von
\fIz\fP und \fIa\ =\ carg(z)\fP ist der »Phasenwinkel«, das Argument von \fIz\fP.
.PP
Es gilt:
.PP
.nf
    tan(carg(z)) = cimag(z) / creal(z)
.fi
.SH RÜCKGABEWERT
Der Rückgabewert liegt im Intervall [\-Pi,Pi].
.SH VERSIONEN
Diese Funktionen kamen erstmals in Glibc 2.1 vor.
.SH ATTRIBUTE
Siehe \fBattributes\fP(7) für eine Erläuterung der in diesem Abschnitt
verwandten Ausdrücke.
.TS
allbox;
lbw24 lb lb
l l l.
Schnittstelle	Attribut	Wert
T{
\fBcarg\fP(),
\fBcargf\fP(),
\fBcargl\fP()
T}	Multithread\-Fähigkeit	MT\-Safe
.TE
.SH "KONFORM ZU"
C99, POSIX.1\-2001, POSIX.1\-2008.
.SH "SIEHE AUCH"
\fBcabs\fP(3), \fBcomplex\fP(7)
.SH KOLOPHON
Diese Seite ist Teil der Veröffentlichung 5.10 des Projekts
Linux\-\fIman\-pages\fP. Eine Beschreibung des Projekts, Informationen, wie
Fehler gemeldet werden können, sowie die aktuelle Version dieser Seite
finden sich unter \%https://www.kernel.org/doc/man\-pages/.
.PP
.SH ÜBERSETZUNG
Die deutsche Übersetzung dieser Handbuchseite wurde von
Martin Eberhard Schauer <Martin.E.Schauer@gmx.de>
und
Dr. Tobias Quathamer <toddy@debian.org>
erstellt.
.PP
Diese Übersetzung ist Freie Dokumentation; lesen Sie die
.UR https://www.gnu.org/licenses/gpl-3.0.html
GNU General Public License Version 3
.UE
oder neuer bezüglich der
Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.
.PP
Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden,
schicken Sie bitte eine E-Mail an die
.MT debian-l10n-german@lists.debian.org
Mailingliste der Übersetzer
.ME .