std::acosh, std::acoshf, std::acoshl
Definido en el archivo de encabezado <cmath>
|
||
float acosh ( float arg ); float acoshf( float arg ); |
(1) | (desde C++11) |
double acosh ( double arg ); |
(2) | (desde C++11) |
long double acosh ( long double arg ); long double acoshl( long double arg ); |
(3) | (desde C++11) |
double acosh ( TipoEntero arg ); |
(4) | (desde C++11) |
arg
.Contenido |
[editar] Parámetros
arg | - | Valor de un tipo de punto flotante o un tipo entero. |
[editar] Valor de retorno
Si no se producen errores, se devuelve el coseno hiperbólico inverso de arg
(cosh-1
(arg), o arcosh(arg)) en el intervalo [0, +∞].
Si se produce un error de dominio, se devuelve un valor definido por la implementación (NaN donde se dé apoyo).
[editar] Manejo de errores
Los errores se informan como se especifica en math_errhandling.
Si el argumento es menor que 1, se produce un error de dominio.
Si la implementación admite la aritmética de punto flotante IEEE (IEC 60559):
- Si el argumento es menor que 1, se genera FE_INVALID 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.
[editar] Notas
Aunque el C estándar (al que se refiere C++ para esta función) denomina esta función "coseno hiperbólico de 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" (usado por POSIX) o "coseno hiperbólico de área".
[editar] Ejemplo
#include <iostream> #include <cmath> #include <cfloat> #include <cerrno> #include <cfenv> #include <cstring> #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 << " Se generó FE_INVALID\n"; }
Posible salida:
acosh(1) = 0 acosh(10) = 2.99322 acosh(DBL_MAX) = 710.476 acosh(Inf) = inf acosh(0.5) = -nan errno == EDOM: Argumento numérico fuera de dominio Se generó FE_INVALID
[editar] Véase también
(C++11)(C++11)(C++11) |
Calcula el seno hiperbólico inverso (arsinh(x)) (función) |
(C++11)(C++11)(C++11) |
Calcula la tangente hiperbólica inversa (artanh(x)) (función) |
(C++11)(C++11) |
Calcula el coseno hiperbólico (cosh(x)) (función) |
(C++11) |
Calcula el área del coseno hiperbólico de un número complejo (arcosh(z)). (plantilla de función) |
Documentación de C para acosh
|
[editar] Enlaces externos
Weisstein, Eric W. "Coseno Hiperbólico Inverso." De MathWorld – Un recurso web de Wolfram.