atanh, atanhf, atanhl

Calcula la tangente hiperbólica inversa.

Sintaxis

double atanh( double x );
float atanhf( float x );
long double atanhl( long double x );
#define atanh(X) // Requires C11 or higher

float atanh( float x );  // C++ only
long double atanh( long double x );  // C++ only

Parámetros

x
Valor de punto flotante.

Valor devuelto

Las atanh funciones devuelven la tangente hiperbólica inversa (tangente hiperbólica de arco) de x. Si x es mayor que 1 o menor que -1, errno se establece en EDOM y el resultado es un NaN silencioso. Si x equivale a 1 o -1, se devuelve un valor infinito positivo o negativo respectivamente, y errno se establece en ERANGE.

Entrada	Excepción SEH	Excepción de _matherr
± QNaN, IND	None	None
X ≥ 1; x ≤ -1	None	None

Comentarios

Puesto que C++ permite las sobrecargas, es posible llamar a las sobrecargas de atanh que toman y devuelven los valores float o long double. En un programa de C, a menos que use la <macro tgmath.h> para llamar a esta función, atanh siempre toma y devuelve double.

Si usa la macro <tgmath.h>atanh(), el tipo del argumento determina qué versión de la función se selecciona. Consulte Matemáticas de tipo genérico para obtener más información.

De manera predeterminada, el estado global de esta función está limitado a la aplicación. Para cambiar este comportamiento, consulte Estado global en CRT.

Requisitos

Función	Encabezado C	Encabezado C++
atanh, atanhf, atanhl	<math.h>	<cmath> o <math.h>
atanhMacro	<tgmath.h>

Para obtener más información sobre compatibilidad, consulte Compatibilidad.

Ejemplo

// crt_atanh.c
// This program displays the hyperbolic tangent of pi / 4
// and the arc hyperbolic tangent of the result.
//

#include <math.h>
#include <stdio.h>

int main( void )
{
   double pi = 3.1415926535;
   double x, y;

   x = tanh( pi / 4 );
   y = atanh( x );
   printf( "tanh( %f ) = %f\n", pi/4, x );
   printf( "atanh( %f ) = %f\n", x, y );
}

tanh( 0.785398 ) = 0.655794
atanh( 0.655794 ) = 0.785398

Consulte también

Compatibilidad con matemáticas y punto flotante
acosh, acoshf, acoshl
asinh, asinhf, asinhl
cosh, coshf, coshl
sinh, sinhf, sinhl
tanh, tanhf, tanhl