Espacios de nombres
Variantes
Acciones

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

De cppreference.com
< cpp‎ | numeric‎ | math
 
 
 
Funciones matemáticas comunes
Funciones
Operaciones básicas
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)(C++11)(C++11)
Funciones exponenciales
(C++11)
(C++11)
(C++11)
(C++11)
Funciones de potencias
(C++11)
(C++11)
Funciones trigonométricas e hiperbólicas
(C++11)
acosh
(C++11)
(C++11)
Funciones de error y gamma
(C++11)
(C++11)
(C++11)
(C++11)
Operaciones de punto flotante del entero más cercano
(C++11)(C++11)(C++11)
(C++11)
(C++11)
(C++11)(C++11)(C++11)
Funciones de manipulación de punto flotante
(C++11)(C++11)
(C++11)
(C++11)
(C++11)(C++11)
(C++11)
Clasificación/comparación
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
Constantes de macro
(C++11)(C++11)(C++11)(C++11)(C++11)
 
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)
1-3) Calcula el coseno hiperbólico inverso de arg.
4) Un conjunto de sobrecargas o una plantilla de función que acepta un argumento de cualquier tipo entero. Equivalente a (2) (el argumento se convierte a double).

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) [editar]
(C++11)(C++11)(C++11)
Calcula la tangente hiperbólica inversa (artanh(x))
(función) [editar]
(C++11)(C++11)
Calcula el coseno hiperbólico (cosh(x))
(función) [editar]
Calcula el área del coseno hiperbólico de un número complejo (arcosh(z)).
(plantilla de función) [editar]

[editar] Enlaces externos

Weisstein, Eric W. "Coseno Hiperbólico Inverso." De MathWorld – Un recurso web de Wolfram.