NOME

       hypot, hypotf, hypotl - função de distância euclidiana

BIBLIOTECA

       Biblioteca matemática (libm, -lm)

SINOPSE

       #include <math.h>

       double hypot(double x, double y);
       float hypotf(float x, float y);
       long double hypotl(long double x, long double y);

   Requisitos de macro de teste de recursos para o glibc (consulte feature_test_macros(7)):

       hypot():
           _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
               || _XOPEN_SOURCE
               || /* Desde o glibc 2.19: */ _DEFAULT_SOURCE
               || /* glibc versões <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

       hypotf(), hypotl():
           _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  retornam sqrt(x*x+y*y). Esse é o comprimento da hipotenusa de um triângulo
       retângulo com lados de comprimento x e y, ou a  distância  do  ponto  (x,y)  a  partir  da
       origem.

       O  cálculo  é  realizado  sem  estouro (oveflow) ou estouro negativo (underflow) indevidos
       durante as etapas intermediárias do cálculo.

VALOR DE RETORNO

       No caso de sucesso, estas funções retornam o comprimento da  hipotenusa  de  um  triângulo
       retângulo com lados de comprimento x e y.

       Se x ou y for um infinito, infinito positivo é retornado.

       Se x ou y for NaN e o outro argumento não for infinito, um NaN é retornado.

       Se  o  resultado é excedido, ocorrerá um erro de intervalo e as funções retornam HUGE_VAL,
       HUGE_VALF ou HUGE_VALL, respectivamente.

       Se ambos os argumentos forem subnormais e o resultado for subnormal,  ocorre  um  erro  de
       intervalo e o resultado correto é 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:

       Erro de intervalo: resultado estouro
              errno  é  definido  com  ERANGE.  Uma  exceção  de  ponto  flutuante   de   estouro
              (FE_OVERFLOW) é levantada.

       Erro de intervalo: resultado estouro negativo
              Uma exceção de ponto flutuante de estouro negativo (FE_OVERFLOW) é levantada.

              Estas funções não definem errno para este caso.

ATRIBUTOS

       Para uma explicação dos termos usados nesta seção, consulte attributes(7).

       ┌───────────────────────────────────────────────────────────────┬───────────────┬─────────┐
       │Interface                                                      │ Atributo      │ Valor   │
       ├───────────────────────────────────────────────────────────────┼───────────────┼─────────┤
       │hypot(), hypotf(), hypotl()                                    │ 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.

VEJA TAMBÉM

       cabs(3), sqrt(3)

TRADUÇÃO

       A  tradução  para português brasileiro desta página man foi criada por Marcelo M. de Abreu
       <mmabreu@terra.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⟩.