BEZEICHNUNG

       atanh, atanhf, atanhl - Areatangens Hyperbolicus

ÜBERSICHT

       #include <math.h>

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

       Linken Sie mit der Option -lm.

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

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

       atanhf(), atanhl():
           _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  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 zulässige 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 mathematischer 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-Safe │
       └──────────────────────────────┴───────────────────────┴─────────┘

KONFORM ZU

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

       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 Version 2.10 verhält sich Glibc richtig.

SIEHE AUCH

       acosh(3), asinh(3), catanh(3), cosh(3), sinh(3), tanh(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 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.

                                               15. September 2017                                       ATANH(3)