Scroll to navigation

ATANH(3) Manual do Programador do Linux 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 versões <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

atanhf(), atanhl():

_ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
|| /* Desde o glibc 2.19: */ _DEFAULT_SOURCE
|| /* Glibc versões <= 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:

errno é definido com EDOM. Uma exceção de ponto flutuante inválida (FE_INVALID) é levantada.
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

No glibc 2.9 e versões anteriores, quando ocorre um erro de polo, errno era definido com EDOM em vez do ERANGE obrigatório para POSIX. Desde a versão 2.10, o glibc faz a coisa certa.

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.10 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 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.

15 setembro 2017