acosh, acoshf, acoshl

Parámetros

Valor de retorno

Si no ocurren errores, se devuelve el coseno hiperbólico inverso de arg ( cosh -1
(arg) , o arcosh(arg) ) en el intervalo [0, +∞] .

Si ocurre un error de dominio, se devuelve un valor definido por la implementación (NaN donde esté soportado).

Manejo de errores

Los errores se reportan como se especifica en math_errhandling .

Si el argumento es menor que 1 , ocurre un error de dominio.

Si la implementación soporta aritmética de punto flotante IEEE (IEC 60559),

• Si el argumento es menor que 1, FE_INVALID se activa y se devuelve NaN.
• Si el argumento es 1, se devuelve +0.
• Si el argumento es +∞, se devuelve +∞.
• Si el argumento es NaN, se devuelve NaN.

Notas

Aunque el estándar de C denomina a esta función "coseno hiperbólico arco", las funciones inversas de las funciones hiperbólicas son las funciones de área. Su argumento es el área de un sector hiperbólico, no un arco. El nombre correcto es "coseno hiperbólico inverso" (utilizado por POSIX) o "coseno hiperbólico de área".

Ejemplo

#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

Referencias

Véase también

Enlaces externos