BEZEICHNUNG

acos, acosf, acosl - die Arkus-Cosinus-Funktion

BIBLIOTHEK

Mathematik-Bibliothek (libm, -lm)

ÜBERSICHT

#include <math.h>

double acos(double x);
float acosf(float x);
long double acosl(long double x);

acosf(), acosl():

    _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
        || /* Seit Glibc 2.19: */ _DEFAULT_SOURCE
        || /* Glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

BESCHREIBUNG

Diese Funktionen berechnen den Arkus-Cosinus von x. Das ist der Wert, dessen Cosinus x ist.

RÜCKGABEWERT

Im Erfolgsfall geben diese Funktionen den Arkus-Cosinus von x in Radiant zurück. Der Rückgabewert ist im Bereich [0, Pi].

Falls x keine zulässige Zahl (»NaN«) ist, wird »NaN« zurückgegeben.

Falls x gleich +1 ist, wird +0 zurückgegeben.

Falls x plus oder minus unendlich ist, tritt ein Wertebereichsfehler auf und es wird »NaN« zurückgegeben.

Falls x außerhalb des Bereichs [-1, 1] ist, tritt ein Wertebereichsfehler auf und es wird »NaN« zurückgegeben.

FEHLER

In math_error(7) erfahren Sie, wie Sie Fehler bei der Ausführung dieser Funktionen erkennen.

Die folgenden Fehler können auftreten:

Wertebereichsfehler: x ist außerhalb des Bereichs [-1, 1]

errno wird auf EDOM gesetzt. Es wird der Fließkomma-Ausnahmefehler »unzulässige Fließkommazahl« (FE_INVALID) ausgelöst.

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

asin(3), atan(3), atan2(3), cacos(3), cos(3), sin(3), tan(3)

ÜBERSETZUNG

Die deutsche Übersetzung dieser Handbuchseite wurde von 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.