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   (consultez
   feature_test_macros(7)) :

       hypot() :
           _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE || _ISOC99_SOURCE ||
           _POSIX_C_SOURCE >= 200112L
           ou cc -std=c99
       hypotf(), hypotl() :
           _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE >= 600 || _ISOC99_SOURCE ||
           _POSIX_C_SOURCE >= 200112L
           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  (« overflow »)  ni  soupassement  (« 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é.

       En  cas  de  dépassement  pour  le  résultat,  une  erreur  d'intervalle se produit et les
       fonctions renvoient HUGE_VAL, HUGE_VALF ou HUGE_VALL, respectivement.

       Si les deux paramètres sont dénormalisés  et  le  résultat  est  dénormalisé,  une  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 : soupassement (« underflow ») du résultat
              Une exception en virgule flottante de soupassement (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.57 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

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

       Christophe   Blaess   <http://www.blaess.fr/christophe/>   (1996-2003),    Alain    Portal
       <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     à
       <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> ».

                                        20 septembre 2010                                HYPOT(3)