BEZEICHNUNG

       atanh, atanhf, atanhl - Areatangens Hyperbolicus

BIBLIOTHEK

       Mathematik-Bibliothek (libm, -lm)

ÜBERSICHT

       #include <math.h>

       double atanh(double x);
       float atanhf(float x);
       long double atanhl(long double x);

   Mit Glibc erforderliche Feature-Test-Makros (siehe feature_test_macros(7)):

       atanh():
       _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
           || _XOPEN_SOURCE >= 500
           || /* Seit Glibc 2.19: */ _DEFAULT_SOURCE
           || /* Glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

       atanhf(), atanhl():
           _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
               || /* Seit Glibc 2.19: */ _DEFAULT_SOURCE
               || /* Glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

BESCHREIBUNG

       Diese  Funktionen  berechnen  den  Areatangens  Hyperbolicus  von  x.  Dies  ist der Wert, dessen Tangens
       Hyperbolicus x ist.

RÜCKGABEWERT

       Nach erfolgreicher Ausführung geben diese Funktionen den Areatangens Hyperbolicus von x zurück.

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

       Falls x gleich +0 (-0) ist, wird +0 (-0) zurückgegeben.

       Wenn x gleich +1 oder -1 ist, tritt ein Polfehler ein. Die Funktionen geben  dann  entsprechend  mit  dem
       korrekten Vorzeichen HUGE_VAL, HUGE_VALF oder HUGE_VALL zurück.

       Wenn der Absolutwert von x größer als 1 ist, tritt ein Eingabe-Bereichsfehler (»domain error«) 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:

       Eingabe-Bereichsfehler: x ist kleiner als -1 oder größer als +1.
              errno  wird  auf  EDOM gesetzt. Es wird der Fließkomma-Ausnahmefehler »unzulässige Fließkommazahl«
              (FE_INVALID) ausgelöst.

       Polfehler: x ist +1 oder -1.
              errno wird auf ERANGE gesetzt (siehe aber FEHLER). Es wird der Fließkomma-Ausnahmefehler »Division
              durch Null« (FE_DIVBYZERO) ausgelöst.

ATTRIBUTE

       Siehe attributes(7) für eine Erläuterung der in diesem Abschnitt verwandten Ausdrücke.
       ┌───────────────────────────────────────────────────────────────────┬───────────────────────┬───────────┐
       │ Schnittstelle                                                     │ Attribut              │ Wert      │
       ├───────────────────────────────────────────────────────────────────┼───────────────────────┼───────────┤
       │ atanh(), atanhf(), atanhl()                                       │ Multithread-Fähigkeit │ MT-Sicher │
       └───────────────────────────────────────────────────────────────────┴───────────────────────┴───────────┘

STANDARDS

       C11, POSIX.1-2008.

GESCHICHTE

       C99, POSIX.1-2001.

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

FEHLER

       Bis einschließlich Glibc 2.9 wurde errno bei Auftreten eines Polfehlers auf EDOM gesetzt, statt  auf  das
       von POSIX vorgeschriebene ERANGE. Seit Glibc 2.10 verhält sich Glibc richtig.

SIEHE AUCH

       acosh(3), asinh(3), catanh(3), cosh(3), sinh(3), tanh(3)

ÜBERSETZUNG

       Die  deutsche  Übersetzung  dieser  Handbuchseite wurde von Markus Schmitt <fw@math.uni-sb.de> und Martin
       Eberhard Schauer <Martin.E.Schauer@gmx.de> 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: debian-l10n-german@lists.debian.org.

Linux man-pages 6.9.1                              2. Mai 2024                                          atanh(3)