NOME¶

atanh, atanhf, atanhl - função de tangente hiperbólica inversa

BIBLIOTECA¶

Biblioteca matemática (libm, -lm)

SINOPSE¶

#include <math.h>

double atanh(double x);
float atanhf(float x);
long double atanhl(long double x);

atanh():

    _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L


        || _XOPEN_SOURCE >= 500


        || /* Desde o glibc 2.19: */ _DEFAULT_SOURCE


        || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

atanhf(), atanhl():

    _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L


        || /* Desde o glibc 2.19: */ _DEFAULT_SOURCE


        || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

DESCRIÇÃO¶

Estas funções calculam a tangente hiperbólica inversa de x, ou seja, o valor cuja tangente hiperbólica é x.

VALOR DE RETORNO¶

No caso de sucesso, estas funções retornam a tangente hiperbólica inversa de x.

Se x é um NaN, um NaN é retornado.

Se x é +0 (-0), +0 (-0) é retornado.

Se x é +1 ou -1, corre um erro de polo e as funções retornam HUGE_VAL, HUGE_VALF ou HUGE_VALL, respectivamente, com o sinal matematicamente correto.

Se o valor absoluto de x é maior que 1, ocorre um erro de domínio e um NaN é retornado.

ERROS¶

Consulte math_error(7) para obter informações sobre como determinar se ocorreu um erro ao chamar essas funções.

Os seguintes erros podem ocorrer:

Domain error: x less than -1 or greater than +1

errno é definido com EDOM. Uma exceção de ponto flutuante inválida (FE_INVALID) é levantada.

Pole error: x is +1 or -1

errno é definido com ERANGE (mas veja BUGS). Uma exceção de ponto flutuante de divisão por zero (FE_DIVBYZERO) é levantada.

ATRIBUTOS¶

Para uma explicação dos termos usados nesta seção, consulte attributes(7).

PADRÕES¶

C11, POSIX.1-2008.

HISTÓRICO¶

C99, POSIX.1-2001.

A variante retornando double também está em conformidade com SVr4, 4.3BSD.

BUGS¶

In glibc 2.9 and earlier, when a pole error occurs, errno is set to EDOM instead of the POSIX-mandated ERANGE. Since glibc 2.10, glibc does the right thing.

VEJA TAMBÉM¶

acosh(3), asinh(3), catanh(3), cosh(3), sinh(3), tanh(3)

TRADUÇÃO¶

A tradução para português brasileiro desta página man foi criada por Paulo César Mendes <drpc@ism.com.br>, André Luiz Fassone <lonely_wolf@ig.com.br> e Rafael Fontenelle <rafaelff@gnome.org>.

Esta tradução é uma documentação livre; leia a Licença Pública Geral GNU Versão 3 ou posterior para as condições de direitos autorais. Nenhuma responsabilidade é aceita.

Se você encontrar algum erro na tradução desta página de manual, envie um e-mail para a lista de discussão de tradutores.