Available in

(3) (3)/fr (3)/ja

Contents

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

DESCRIPTION

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 [AT] gmail.com> et l’équipe francophone de traduction de Debian.

Veuillez signaler toute erreur de traduction en écrivant à <debian−l10n−french [AT] lists.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> ».

COMMENTS

blog comments powered by Disqus