acosh, acoshf, acoshl

Paramètres

Valeur de retour

Si aucune erreur ne se produit, le cosinus hyperbolique inverse de arg ( cosh -1
(arg) , ou arcosh(arg) ) 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 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 ».

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("acosh(1) = %f\nacosh(10) = %f\n", acosh(1), acosh(10));
    printf("acosh(DBL_MAX) = %f\nacosh(Inf) = %f\n", acosh(DBL_MAX), acosh(INFINITY));
    // error handling
    errno = 0; feclearexcept(FE_ALL_EXCEPT);
    printf("acosh(0.5) = %f\n", acosh(0.5));
    if (errno == EDOM)
        perror("    errno == EDOM");
    if (fetestexcept(FE_INVALID))
        puts("    FE_INVALID raised");
}

acosh(1) = 0.000000
acosh(10) = 2.993223
acosh(DBL_MAX) = 710.475860
acosh(Inf) = inf
acosh(0.5) = -nan
    errno == EDOM: Numerical argument out of domain
    FE_INVALID raised

Références

Voir aussi

Liens externes