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

       Die Funktion atanh() berechnet 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.

KONFORM ZU

       C99,  POSIX.1-2001.  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

       This page is part of release 3.54 of the Linux man-pages project.  A  description  of  the
       project,     and    information    about    reporting    bugs,    can    be    found    at
       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>.

                                        11. September 2010                               ATANH(3)