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

C99, POSIX.1-2001, POSIX.1-2008.

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.