Man page - hypotf(3)

Packages contains this manual

Available languages:

en fr pt_BR pl cs ja ru de

Manual

hypot

NOME
BIBLIOTECA
SINOPSE
DESCRIÇÃO
VALOR DE RETORNO
ERROS
ATRIBUTOS
PADRÕES
HISTÓRICO
VEJA TAMBÉM
TRADUÇÃO

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

Image grohtml-3936643-1.png

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 .