Provided by: manpages-pt-br-dev_4.23.1-1_all
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 ⟨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⟩.