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.

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