atanh, atanhf, atanhl

Artigo
06/09/2015

Calcula a tangente hiperbólica inversa.

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

Parâmetros

x
Valor de ponto flutuante.

Valor de retorno

As funções atanh retornam a tangente hiperbólica inversa (tangente hiperbólica de 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	Matherr Exceção
± 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 programas C, atanh sempre usa e retorna double.

Requisitos

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

Para obter informações adicionais 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 );
}