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

Linken Sie mit der Option -lm.

Mit Glibc erforderliche Makros (siehe feature_test_macros(7)):

atan2f(), atan2l():

_ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
    || /* Seit Glibc 2.19: */ _DEFAULT_SOURCE
    || /* Glibc-Versionen <= 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

KONFORM ZU

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

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

KOLOPHON

Diese Seite ist Teil der Veröffentlichung 4.06 des Projekts Linux-man-pages. Eine Beschreibung des Projekts, Informationen, wie Fehler gemeldet werden können sowie die aktuelle Version dieser Seite finden sich unter https://www.kernel.org/doc/man-pages/.

ÜBERSETZUNG

Die deutsche Übersetzung dieser Handbuchseite wurde von Markus Schmitt <[email protected]>, Martin Eberhard Schauer <[email protected]> und Dr. Tobias Quathamer <[email protected]> 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 <[email protected]>.