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);

   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 │
       └─────────────────────────────────────────────────────────────────────────────┴───────────────┴─────────┘

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.

Linux man-pages 6.8                                2 maio 2024                                          atanh(3)