atanh, atanhf, atanhl

Calcula a tangente hiperbólica inversa.

Sintaxe

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 ponto flutuante.

Valor retornado

As atanh funções retornam a tangente hiperbólica inversa (tangente hiperbólica do arco) de x. Se x for maior que 1 ou menor que -1, errno é definido como EDOM e o resultado é um NaN silencioso. Se x for igual a 1 ou -1, um infinito positivo ou negativo é retornado, respectivamente, e errno é definido como ERANGE.

Entrada	Exceção SEH	Exceção _matherr
± QNaN, IND	nenhum	nenhum
X ≥ 1; x ≤ -1	nenhum	nenhum

Comentários

Como C++ permite sobrecargas, é possível chamar sobrecargas de atanh e que utilizam e retornam valores de float ou long double. Em um programa C, a menos que você esteja usando a <macro tgmath.h> para chamar essa função, atanh sempre usa e retorna double.

Se você usa a macro <tgmath.h>atanh(), o tipo do argumento determina qual versão da função será selecionada. Confira Matemática do tipo genérico para obter detalhes.

Por padrão, o estado global dessa função tem como escopo o aplicativo. Para alterar esse comportamento, confira Estado global no CRT.

Requisitos

Função	Cabeçalho C	Cabeçalho C++
atanh, atanhf, atanhl	<math.h>	<cmath> ou <math.h>
Macro atanh	<tgmath.h>

Para obter informações sobre compatibilidade, consulte Compatibilidade.

Exemplo

// 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

Confira também

Suporte matemático e de ponto flutuante
acosh, acoshf, acoshl
asinh, asinhf, asinhl
cosh, coshf, coshl
sinh, sinhf, sinhl
tanh, tanhf, tanhl