atanh(3)

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 (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).