atanh, atanhf, atanhlatanh, atanhf, atanhl

Calcula la tangente hiperbólica inversa.Calculates the inverse hyperbolic tangent.

SintaxisSyntax

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ámetrosParameters

x1x
Valor de punto flotante.Floating-point value.

Valor devueltoReturn Value

Las funciones atanh devuelven la tangente hiperbólico inversa (arcotangente hiperbólica) de x.The atanh functions return the inverse hyberbolic tangent (arc hyperbolic tangent) of x. Si x es mayor que 1 o menor que-1, errno se establece en EDOM y el resultado es un Nan silencioso.If x is greater than 1, or less than -1, errno is set to EDOM and the result is a quiet NaN. Si x es igual a 1 o-1, se devuelve un valor infinito positivo o negativo, respectivamente, y errno se establece en ERANGE.If x is equal to 1 or -1, a positive or negative infinity is returned, respectively, and errno is set to ERANGE.

EntradaInput Excepción SEHSEH Exception Matherr ExcepcionalMatherr Exception
± QNAN,IND± QNAN,IND ningunonone ningunonone
X ≥ 1; x ≤-1X ≥ 1; x ≤ -1 ningunonone ningunonone

ObservacionesRemarks

Dado que C++ permite las sobrecargas, puede llamar a las sobrecargas de atanh que toman y devuelven float long double los valores o.Because C++ allows overloading, you can call overloads of atanh that take and return float or long double values. En un programa de C, a menos que esté usando la <tgmath.h> macro para llamar a esta función, atanh siempre toma y devuelve double .In a C program, unless you're using the <tgmath.h> macro to call this function, atanh always takes and returns double.

Si usa la <tgmath.h> atanh() macro, el tipo del argumento determina qué versión de la función está seleccionada.If you use the <tgmath.h> atanh() macro, the type of the argument determines which version of the function is selected. Vea Math de tipo genérico para obtener más información.See Type-generic math for details.

De forma predeterminada, el ámbito de este estado global de esta función es la aplicación.By default, this function's global state is scoped to the application. Para cambiar esto, vea estado global en CRT.To change this, see Global state in the CRT.

RequisitosRequirements

FunciónFunction Encabezado CC header Encabezado C++C++ header
atanh, atanhf (, atanhlatanh, atanhf, atanhl <math.h> <cmath> o <math.h><cmath> or <math.h>
Atanh () (macro)atanh() macro <tgmath.h>

Para obtener información adicional sobre compatibilidad, consulte Compatibilidad.For additional compatibility information, see Compatibility.

EjemploExample

// 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énSee also

Compatibilidad de punto flotanteFloating-Point Support
acosh, acoshf, acoshlacosh, acoshf, acoshl
asinh, asinhf, asinhlasinh, asinhf, asinhl
cosh, coshf, coshlcosh, coshf, coshl
sinh, sinhf, sinhlsinh, sinhf, sinhl
tanh, tanhf, tanhltanh, tanhf, tanhl