.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright 2002 Walter Harms (walter.harms@informatik.uni-oldenburg.de)
.\"
.\" SPDX-License-Identifier: GPL-1.0-or-later
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH carg 3 "20. Juli 2023" "Linux man\-pages 6.05.01" 
.SH BEZEICHNUNG
carg, cargf, cargl \- berechnet den Phasenwinkel einer komplexen Zahl
.SH BIBLIOTHEK
Mathematik\-Bibliothek (\fIlibm\fP, \fI\-lm\fP)
.SH ÜBERSICHT
.nf
\fB#include <complex.h>\fP
.PP
\fBdouble carg(double complex \fP\fIz\fP\fB);\fP
\fBfloat cargf(float complex \fP\fIz\fP\fB);\fP
\fBlong double cargl(long double complex \fP\fIz\fP\fB);\fP
.fi
.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
.in +4n
.EX
z = x + I * y
.EE
.in
.PP
mit \fIx\~=\~creal(z)\fP und \fIy\~=\~cimag(z)\fP.
.PP
Die Beschreibung in Polarkoordinaten ist
.PP
.in +4n
.EX
z = r * cexp(I * a)
.EE
.in
.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
.in +4n
.EX
tan(carg(z)) = cimag(z) / creal(z)
.EE
.in
.SH RÜCKGABEWERT
Der Rückgabewert liegt im Intervall [\-Pi,Pi].
.SH ATTRIBUTE
Siehe \fBattributes\fP(7) für eine Erläuterung der in diesem Abschnitt
verwandten Ausdrücke.
.TS
allbox;
lbx lb lb
l l l.
Schnittstelle	Attribut	Wert
T{
.na
.nh
\fBcarg\fP(),
\fBcargf\fP(),
\fBcargl\fP()
T}	Multithread\-Fähigkeit	MT\-Sicher
.TE
.sp 1
.SH STANDARDS
C11, POSIX.1\-2008.
.SH GESCHICHTE
Glibc 2.1. C99, POSIX.1\-2001.
.SH "SIEHE AUCH"
\fBcabs\fP(3), \fBcomplex\fP(7)
.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 .