Scroll to navigation

HYPOT(3) Manuel du programmeur Linux HYPOT(3)

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 :

errno est configurée à ERANGE. Une exception de dépassement en virgule flottante (FE_OVERFLOW) est levée.
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 <URL:http://www.kernel.org/doc/man-pages/>.

TRADUCTION

Depuis 2010, cette traduction est maintenue à l'aide de l'outil po4a <URL:http://po4a.alioth.debian.org/> par l'équipe de traduction francophone au sein du projet perkamon <URL:http://alioth.debian.org/projects/perkamon/>.

Christophe Blaess <URL:http://www.blaess.fr/christophe/> (1996-2003), Alain Portal <URL:http://manpagesfr.free.fr/> (2003-2006). Florentin Duneau et l'équipe francophone de traduction de Debian (2006-2009).

Veuillez signaler toute erreur de traduction en écrivant à <perkamon-l10n-fr@lists.alioth.debian.org>.

Vous pouvez toujours avoir accès à la version anglaise de ce document en utilisant la commande « LC_ALL=C man <section> <page_de_man> ».

5 août 2008