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

                                          22 março 2021                                  ATANH(3)