WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen