atan2(3) | Library Functions Manual | atan2(3) |
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);
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-Sicher |
STANDARDS
C11, POSIX.1-2008.
GESCHICHTE
C99, POSIX.1-2001.
Die Variante, die double zurückgibt, ist außerdem konform zu SVr4, 4.3BSD, C89.
SIEHE AUCH
Ü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 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.
2. Mai 2024 | Linux man-pages 6.8 |