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

       C11, POSIX.1-2008.

HISTÓRICO

       C99, POSIX.1-2001.

       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 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                                          hypot(3)