NOM
hypot, hypotf, hypotl - Distance euclidienne
SYNOPSIS
#include <math.h>
double hypot(double x, double y);
float hypotf(float x, float y);
long double hypotl(long double x, long double y);
Effectuez l’édition des liens avec l’option -lm.
Exigences de macros de test de fonctionnalités pour la glibc (voir
feature_test_macros(7)) :
hypot() : _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE ||
_ISOC99_SOURCE ; ou cc -std=c99
hypotf(), hypotl() : _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE>= 600
|| _ISOC99_SOURCE ; ou cc -std=c99
La fonction hypot() renvoie la valeur sqrt(x*x+y*y). C’est la longueur
de l’hypoténuse d’un triangle rectangle de côtés x et y. C’est
également la distance entre un point de coordonnées (x,y) et l’origine.
Le calcul est effectué sans dépassement ou sous-passement
(« underflow ») dans les étapes intermédiaires du calcul.
VALEUR RENVOYÉE
En cas de réussite, ces fonction renvoient la longueur de l’hypoténuse
d’un triangle rectangle de côtés de longueurs x et y.
Si x ou y est une valeur infinie, une valeur infinie positive est
renvoyée.
Si x ou y est un NaN (pas un nombre : « Not a Number »), et l’autre
paramètre n’est pas infini, un NaN est renvoyé.
Si un dépassement se produit pour le résultat, une erreur d’intervalle
se produit et les fonctions renvoient HUGE_VAL, HUGE_VALF ou HUGE_VALL,
respectivement.
Si les paramètres sont sous normal et le résultat est sous normal, un
erreur d’intervalle est déclenchée, et le résultat correct est renvoyé.
ERREURS
Consultez math_error(7) pour savoir comment déterminer qu’ une erreur
est survenue lors de l’appel de ces fonctions.
Les erreurs suivantes peuvent se produire :
Erreur d’intervalle : dépassement pour le résultat
errno est configurée à ERANGE. Une exception de dépassement en
virgule flottante (FE_OVERFLOW) est levée.
Erreur d’intervalle : sous-passement (« underflow ») du résultat
Une exception en virgule flottante de sous-passement
(FE_UNDERFLOW) est levée.
Ces fonctions ne positionnent pas errno dans ce cas.
CONFORMITÉ
C99, POSIX.1-2001. La variante renvoyant un double est également
conforme à SVr4 et BSD 4.3.
VOIR AUSSI
cabs(3), sqrt(3)
COLOPHON
Cette page fait partie de la publication 3.23 du projet man-pages
Linux. Une description du projet et des instructions pour signaler des
anomalies peuvent être trouvées à l’adresse
http://www.kernel.org/doc/man-pages/.
TRADUCTION
Cette page de manuel a été traduite et mise à jour par Christophe
Blaess <http://www.blaess.fr/christophe/> entre 1996 et 2003, puis par
Alain Portal <aportal AT univ-montp2 DOT fr> jusqu’en 2006, et mise à
disposition sur http://manpagesfr.free.fr/.
Les mises à jour et corrections de la version présente dans Debian sont
directement gérées par Florentin Duneau <fduneau@gmail.com> et l’équipe
francophone de traduction de Debian.
Veuillez signaler toute erreur de traduction en écrivant à
<debian-l10n-french@lists.debian.org> ou par un rapport de bogue sur le
paquet manpages-fr.
Vous pouvez toujours avoir accès à la version anglaise de ce document
en utilisant la commande « man -L C <section> <page_de_man> ».
5 août 2008 HYPOT(3)