CKTIS / C
atanh — C23-Bibliotheksfunktion
`atanh(double x)` aus `<math.h>` liefert den reellen Hauptwert des inversen hyperbolischen Tangens. Für ein endliches reelles Ergebnis muss das Argument im offenen Intervall `(-1, 1)` liegen.
Version: C23
Syntax
double atanh(double x);atanh(double x) aus <math.h> liefert den reellen Hauptwert des inversen hyperbolischen Tangens. Für ein endliches reelles Ergebnis muss das Argument im offenen Intervall (-1, 1) liegen.
Sie kehrt eine tanh-Beziehung um, etwa um einen hyperbolischen Parameter aus einem beschränkten Verhältnis zu gewinnen. Das Beispiel berechnet tatsächlich atanh(0.5) und gibt 0.549 aus.
Im grundlegenden C23 kann bei x = ±1 ein Polfehler auftreten und der Rückgabewert ist implementierungsdefiniert; für |x| > 1 tritt ein Definitionsbereichsfehler mit ebenfalls implementierungsdefiniertem Wert auf. Bei einem von null verschiedenen, extrem kleinen x kann ein Bereichsfehler durch Unterlauf entstehen. Erst Annex F für IEC 60559 verlangt ±0, vorzeichenbehaftete Unendlichkeiten samt Division-durch-null bei ±1, NaN samt invalid außerhalb des Bereichs und NaN-Weitergabe.
Beispiele
#include <math.h>
#include <stdio.h>
int main(void) {
double value = atanh(0.5);
printf("%.3f\n", value);
return 0;
}
Ergebnis
0.549
Sie kehrt eine `tanh`-Beziehung um, etwa um einen hyperbolischen Parameter aus einem beschränkten Verhältnis zu gewinnen. Das Beispiel berechnet tatsächlich `atanh(0.5)` und gibt `0.549` aus.