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 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 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-Safe │
       └───────────────────────────────────────────────────────┴───────────────────────┴─────────┘

STANDARDS

       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  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 ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ 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⟩.