BEZEICHNUNG

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

ÜBERSICHT

       #include <math.h>

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

       Linken Sie mit der Option -lm.

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

       acosf(), acosl():
           _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 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 mathematischer 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.
       ┌──────────────────────────┬───────────────────────┬─────────┐
       │ Schnittstelle            │ Attribut              │ Wert    │
       ├──────────────────────────┼───────────────────────┼─────────┤
       │ acos(), acosf(), acosl() │ 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.

SIEHE AUCH

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

KOLOPHON

       Diese Seite ist Teil der Veröffentlichung  5.10  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 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.

                                               15. September 2017                                        ACOS(3)