table of contents
- bookworm 4.18.1-1
- bookworm-backports 4.25.0-1~bpo12+1
- testing 4.25.0-1
- unstable 4.25.0-1
atanh(3) | Library Functions Manual | atanh(3) |
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).
Interface | Atributo | Valor |
atanh(), atanhf(), atanhl() | Thread safety | MT-Safe |
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¶
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.
5 fevereiro 2023 | Linux man-pages 6.03 |