BEZEICHNUNG

       atan2, atan2f, atan2l - die Arkustangens-Funktion zweier Variablen

BIBLIOTHEK

       Mathematik-Bibliothek (libm, -lm)

ÜBERSICHT

       #include <math.h>

       double atan2(double y, double x);
       float atan2f(float y, float x);
       long double atan2l(long double y, long double x);

   Mit Glibc erforderliche Feature-Test-Makros (siehe feature_test_macros(7)):

       atan2f(), atan2l():
           _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
               || /* Seit Glibc 2.19: */ _DEFAULT_SOURCE
               || /* Glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

BESCHREIBUNG

       Diese  Funktionen berechnen den Hauptwert des Arkustangens von y/x. Mit den Vorzeichen der
       beiden Argumente wird der Quadrant des Ergebnisses bestimmt.

RÜCKGABEWERT

       Bei Erfolg geben diese Funktionen den Hauptwert  des  Arkustangens  von  y/x  im  Bogenmaß
       zurück; der Rückgabewert liegt im Intervall [-Pi, Pi].

       Wenn y gleich +0 (-0) und x kleiner als 0 ist, wird +Pi (-Pi) zurückgegeben.

       Wenn y gleich +0 (-0) und x größer als 0 ist, wird +0 (-0) zurückgegeben.

       Wenn y kleiner als 0 ist und x ist +0 oder -0, wird -Pi/2 zurückgegeben.

       Wenn y größer als 0 und x gleich +0 oder -0 ist, wird Pi/2 zurückgegeben.

       Wenn  entweder  x  oder  y  ein  NaN  (»Not  a  Number«,  keine  Zahl)  ist,  wird ein NaN
       zurückgegeben.

       Wenn y gleich +0 (-0) und x gleich -0 ist, wird +Pi (-Pi) zurückgegeben.

       Wenn y gleich +0 (-0) und x gleich +0 ist, wird +0 (-0) zurückgegeben.

       Ist y ein endlicher Wert größer (kleiner) als 0 und ist x minus unendlich, wird +Pi  (-Pi)
       zurückgegeben.

       Ist  y  ein  endlicher  Wert größer (kleiner) als 0 und ist x plus unendlich, wird +0 (-0)
       zurückgegeben.

       Ist y plus unendlich (minus unendlich) und ist x endlich, wird Pi/2 (-Pi/2) zurückgegeben.

       Ist y plus unendlich (minus unendlich) und ist x minus unendlich,  wird  3*Pi/4  (-3*Pi/4)
       zurückgegeben.

       Ist  y  plus  unendlich  (minus  unendlich)  und  ist  x plus unendlich, wird Pi/4 (-Pi/4)
       zurückgegeben.

FEHLER

       Es treten keine Fehler auf.

ATTRIBUTE

       Siehe attributes(7) für eine Erläuterung der in diesem Abschnitt verwandten Ausdrücke.

       ┌───────────────────────────────────────────────────────┬───────────────────────┬─────────┐
       │Schnittstelle                                          │ Attribut              │ Wert    │
       ├───────────────────────────────────────────────────────┼───────────────────────┼─────────┤
       │atan2(), atan2f(), atan2l()                            │ Multithread-Fähigkeit │ MT-Safe │
       └───────────────────────────────────────────────────────┴───────────────────────┴─────────┘

STANDARDS

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

       Die Variante, die double zurückgibt, ist außerdem konform zu SVr4, 4.3BSD.

SIEHE AUCH

       acos(3), asin(3), atan(3), carg(3), cos(3), sin(3), tan(3)

ÜBERSETZUNG

       Die deutsche Übersetzung dieser  Handbuchseite  wurde  von  Markus  Schmitt  <fw@math.uni-
       sb.de>,  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⟩.