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

Parámetros

Valor de retorno

Si no ocurren errores, se devuelve el coseno hiperbólico inverso de num ( cosh -1
(num) , o arcosh(num) ) 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 retorna NaN.
• si el argumento es 1, se retorna +0.
• si el argumento es +∞, se retorna +∞.
• si el argumento es NaN, se retorna NaN.

Notas

Aunque el estándar C (al que C++ hace referencia para esta función) denomina 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 área".

Las sobrecargas adicionales no requieren ser proporcionadas exactamente como (A) . Solo necesitan ser suficientes para garantizar que para su argumento num de tipo entero, std :: acosh ( num ) tenga el mismo efecto que std :: acosh ( static_cast < double > ( num ) ) .

Ejemplos

#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';
    // manejo de errores
    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 raised\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 raised

Véase también

Enlaces externos