std:: acosh, std:: acoshf, std:: acoshl

Paramètres

Valeur de retour

Si aucune erreur ne se produit, le cosinus hyperbolique inverse de num ( cosh -1
(num) , ou arcosh(num) ) sur l'intervalle [0, +∞] , est retourné.

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

Gestion des erreurs

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

Si l'argument est inférieur à 1, une erreur de domaine se produit.

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

• si l'argument est inférieur à 1, FE_INVALID est déclenchée et NaN est retourné.
• si l'argument est 1, +0 est retourné.
• si l'argument est +∞, +∞ est retourné.
• 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 « cosinus 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 « cosinus hyperbolique inverse » (utilisé par POSIX) ou « cosinus hyperbolique d'aire ».

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 :: acosh ( num ) ait le même effet que std :: acosh ( static_cast < double > ( num ) ) .

Exemples

#include <cerrno>
#include <cfenv>
#include <cfloat>
#include <cmath>
#include <cstring>
#include <iostream>
// #pragma STDC FENV_ACCESS ON
int main()
{
    std::cout << "acosh(1) = " << std::acosh(1) << '\n'
              << "acosh(10) = " << std::acosh(10) << '\n'
              << "acosh(DBL_MAX) = " << std::acosh(DBL_MAX) << '\n'
              << "acosh(Inf) = " << std::acosh(INFINITY) << '\n';
    // gestion des erreurs
    errno = 0;
    std::feclearexcept(FE_ALL_EXCEPT);
    std::cout << "acosh(0.5) = " << std::acosh(0.5) << '\n';
    if (errno == EDOM)
        std::cout << "    errno == EDOM: " << std::strerror(errno) << '\n';
    if (std::fetestexcept(FE_INVALID))
        std::cout << "    FE_INVALID levée\n";
}

acosh(1) = 0
acosh(10) = 2.99322
acosh(DBL_MAX) = 710.476
acosh(Inf) = inf
acosh(0.5) = -nan
    errno == EDOM: Numerical argument out of domain
    FE_INVALID levée

Voir aussi

Liens externes