focal (3) hypot.3.gz

Provided by: manpages-fr-dev_3.65d1p1-1_all bug

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