Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C

atanh — fonction de bibliothèque C23

`atanh(double x)` de `<math.h>` renvoie la valeur principale réelle de la tangente hyperbolique inverse. Pour un résultat réel fini, l’argument doit appartenir à l’intervalle ouvert `(-1, 1)`.

Version : C23

Syntaxe

double atanh(double x);

atanh(double x) de <math.h> renvoie la valeur principale réelle de la tangente hyperbolique inverse. Pour un résultat réel fini, l’argument doit appartenir à l’intervalle ouvert (-1, 1).

Elle inverse une relation tanh, par exemple pour retrouver un paramètre hyperbolique depuis un rapport borné. L’exemple calcule réellement atanh(0.5) et affiche 0.549.

Dans le C23 de base, une erreur de pôle peut survenir pour x = ±1 et la valeur renvoyée dépend de l’implémentation ; pour |x| > 1, une erreur de domaine survient avec une valeur également définie par l’implémentation. Une erreur de plage peut survenir pour un x non nul si petit que le résultat sous-déborde. L’annexe F pour IEC 60559 impose ±0, les infinis signés avec division par zéro à ±1, NaN avec invalid hors domaine et la propagation de NaN.

Exemples

#include <math.h>
#include <stdio.h>

int main(void) {
    double value = atanh(0.5);
    printf("%.3f\n", value);
    return 0;
}

Résultat

0.549

Elle inverse une relation `tanh`, par exemple pour retrouver un paramètre hyperbolique depuis un rapport borné. L’exemple calcule réellement `atanh(0.5)` et affiche `0.549`.

Sources