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);

    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).