atanh, atanhf, atanhl

Paramètres

Valeur de retour

Si aucune erreur ne se produit, la tangente hyperbolique inverse de arg ( tanh -1
(arg) , ou artanh(arg) ), est retournée.

Si une erreur de domaine se produit, une valeur définie par l'implémentation est retournée (NaN là où supporté).

Si une erreur de pôle se produit, ± HUGE_VAL , ±HUGE_VALF , ou ±HUGE_VALL est retourné (avec le signe correct).

Si une erreur de plage se produit en raison d'un dépassement inférieur, le résultat correct (après arrondi) est retourné.

Gestion des erreurs

Les erreurs sont signalées comme spécifié dans math_errhandling .

Si l'argument n'est pas sur l'intervalle [ - 1 , + 1 ] , une erreur de plage se produit.

Si l'argument est ±1, une erreur de pôle se produit.

Si l'implémentation prend en charge l'arithmétique à virgule flottante IEEE (IEC 60559),

• Si l'argument est ±0, il est retourné inchangé.
• Si l'argument est ±1, ±∞ est retourné et FE_DIVBYZERO est déclenché.
• Si |arg|>1 , NaN est retourné et FE_INVALID est déclenché.
• Si l'argument est NaN, NaN est retourné.

Notes

Bien que la norme C nomme cette fonction « tangente hyperbolique inverse », les fonctions inverses des fonctions hyperboliques sont les fonctions d'aire. Leur argument est l'aire d'un secteur hyperbolique, et non un arc. Le nom correct est « tangente hyperbolique inverse » (utilisé par POSIX) ou « tangente hyperbolique d'aire ».

POSIX spécifie qu'en cas de dépassement inférieur, arg est retourné non modifié, et si cela n'est pas pris en charge, une valeur définie par l'implémentation non supérieure à DBL_MIN , FLT_MIN , et LDBL_MIN est retournée.

Exemple

#include <errno.h>
#include <fenv.h>
#include <float.h>
#include <math.h>
#include <stdio.h>
// #pragma STDC FENV_ACCESS ON
int main(void)
{
    printf("atanh(0) = %f\natanh(-0) = %f\n", atanh(0), atanh(-0.0));
    printf("atanh(0.9) = %f\n", atanh(0.9));
    // error handling
    errno = 0; feclearexcept(FE_ALL_EXCEPT);
    printf("atanh(-1) = %f\n", atanh(-1));
    if (errno == ERANGE)
        perror("    errno == ERANGE");
    if (fetestexcept(FE_DIVBYZERO))
        puts("    FE_DIVBYZERO raised");
}

atanh(0) = 0.000000
atanh(-0) = -0.000000
atanh(0.9) = 1.472219
atanh(-1) = -inf
    errno == ERANGE: Résultat numérique hors limites
    FE_DIVBYZERO raised

Références

Voir aussi

Liens externes