ATANH(3)

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

SINOPSE
#include <math.h>

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

Vincule com -lm.

    Requisitos de macro de teste de recursos para o glibc (consulte feature_test_macros(7)):

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).
Interface | Atributo | Valor
atanh(), atanhf(), atanhl() | Thread safety | MT-Safe

DE ACORDO COM
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 version 2.10, glibc does the right thing.

VEJA TAMBÉM
acosh(3), asinh(3), catanh(3), cosh(3), sinh(3), tanh(3)

COLOFÃO
Esta página faz parte da versão 5.13 do projeto Linux man-pages. Uma descrição do projeto, informações sobre relatórios de bugs e a versão mais recente desta página podem ser encontradas em https://www.kernel.org/doc/man-pages/.

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 (https://www.gnu.org/licenses/gpl-3.0.html) 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 (debian-l10n-portuguese@lists.debian.org).