std:: atanh, std:: atanhf, std:: atanhl

Paramètres

Valeur de retour

Si aucune erreur ne se produit, l'arc tangente hyperbolique de num ( tanh -1
(num) , ou artanh(num) ), est retourné.

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 domaine 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 |num|>1 , NaN est retourné et FE_INVALID est déclenché.
• si l'argument est NaN, NaN est retourné.

Notes

Bien que la norme C (à laquelle le C++ se réfère pour cette fonction) 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, num 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.

Les surcharges supplémentaires ne sont pas requises d'être fournies exactement comme (A) . Elles doivent seulement être suffisantes pour garantir que pour leur argument num de type entier, std :: atanh ( num ) ait le même effet que std :: atanh ( static_cast < double > ( num ) ) .

Exemple

#include <cerrno>
#include <cfenv>
#include <cfloat>
#include <cmath>
#include <cstring>
#include <iostream>
// #pragma STDC FENV_ACCESS ON
int main()
{
    std::cout << "atanh(0) = " << std::atanh(0) << '\n'
              << "atanh(-0) = " << std::atanh(-0.0) << '\n'
              << "atanh(0.9) = " << std::atanh(0.9) << '\n';
    // gestion des erreurs
    errno = 0;
    std::feclearexcept(FE_ALL_EXCEPT);
    std::cout << "atanh(-1) = " << std::atanh(-1) << '\n';
    if (errno == ERANGE)
        std::cout << "    errno == ERANGE: " << std::strerror(errno) << '\n';
    if (std::fetestexcept(FE_DIVBYZERO))
        std::cout << "    FE_DIVBYZERO levée\n";
}

atanh(0) = 0
atanh(-0) = -0
atanh(0.9) = 1.47222
atanh(-1) = -inf
    errno == ERANGE: Résultat numérique hors limites
    FE_DIVBYZERO levée

Voir aussi

Liens externes