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:

       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

       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
       ⟨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⟩.

                                         15 setembro 2017                                ATANH(3)