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():
           _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE >= 500 ||
           _XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED || _ISOC99_SOURCE ||
           _POSIX_C_SOURCE >= 200112L;
           oder cc -std=c99
       atanhf(), atanhl():
           _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE >= 600 || _ISOC99_SOURCE ||
           _POSIX_C_SOURCE >= 200112L;
           oder cc -std=c99

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, C89.

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  4.04  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 http://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 <debian-l10n-german@lists.debian.org>.

                                          19. April 2015                                 ATANH(3)