Provided by: manpages-fr-dev_3.27fr1.4-1_all bug

NOM

       pow, powf, powl - Fonction puissance

SYNOPSIS

       #include <math.h>

       double pow(double x, double y);
       float powf(float x, float y);
       long double powl(long double x, long double y);

       Effectuez l'edition des liens avec l'option -lm.

   Exigences  de  macros  de  test de fonctionnalites pour la glibc (consultez
   feature_test_macros(7)) :

       powf(), powl() :
           _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE >= 600 ||
           _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
           ou cc -std=c99

DESCRIPTION

       La fonction pow() renvoie la valeur de x eleve a la puissance y.

VALEUR RENVOY'EE

       En  cas de reussite, ces fonctions renvoient la valeur de x elevee a la
       puissance y.

       Si x est une valeur finie negative et y une nombre fini non-entier, une
       erreur de domaine se produit et un NaN est renvoye.

       En  cas  de  depassement  pour  le resultat, une erreur d'intervalle se
       produit et les fonctions renvoient HUGE_VAL,  HUGE_VALF  ou  HUGE_VALL,
       respectivement, avec le bon signe mathematique.

       En  cas de soupassement (<< underflow >>) pour le resultat, et qu'il ne
       peut pas etre represente, une erreur d'intervalle se produit et  0  est
       renvoye.

       Sauf  dans  les  cas  specifies  ci-dessous,  si  x ou y est un NaN, le
       resultat est un NaN.

       Si x vaut +1, le resultat est 1,0 (meme si y est un NaN).

       Si y est nul, le resultat est 1,0 (meme si x est un NaN).

       Si x vaut +0 (respectivement, -0) et y  est  un  nombre  entier  impair
       positif, le resultat est +0 (respectivement, -0).

       Si  x  est  nul  et  y positif et n'est pas un nombre entier impair, le
       resultat est +0.

       Si x vaut -1 et y est une  valeur  infinie  positive  ou  negative,  le
       resultat est 1,0.

       Si  la  valeur  absolue  de  x  est  inferieure a 1 et y est une valeur
       infinie negative, le resultat est l'infini positif.

       Si la valeur absolue de x est superieure  a  1  et  y  est  une  valeur
       infinie negative, le resultat est +0.

       Si  la  valeur  absolue  de  x  est  inferieure a 1 et y est une valeur
       infinie positive, le resultat est +0.

       Si la valeur absolue de x est superieure  a  1  et  y  est  une  valeur
       infinie positive, le resultat est l'infini positif.

       Si  x  est une valeur infinie negative et y est un nombre entier impair
       negatif, le resultat est -0.

       Si x est une valeur infinie negative et y est negatif et n'est  pas  un
       nombre entier impair, le resultat est +0.

       Si  x  est une valeur infinie negative et y est un nombre entier impair
       positif, le resultat est l'infini negatif.

       Si x est une valeur infinie negative et y est positif et n'est  pas  un
       nombre entier impair, le resultat est l'infini positif.

       Si  x est une valeur infinie positive et y est negatif, le resultat est
       +0.

       Si x est une valeur infinie positive et y est positif, le resultat  est
       l'infini positif.

       Si  x  vaut  +0  ou  -0  et y est une nombre entier impair negatif, une
       erreur de pole se produit  et  HUGE_VAL,  HUGE_VALF  ou  HUGE_VALL  est
       renvoye avec le meme signe que x.

       Si x vaut +0 ou -0 et y est negatif et pas un nombre impair, une erreur
       de pole se produit et +HUGE_VAL, +HUGE_VALF ou +HUGE_VALL est renvoye.

ERREURS

       Consultez math_error(7) pour savoir comment  determiner  qu'une  erreur
       est survenue lors de l'appel de ces fonctions.

       Les erreurs suivantes peuvent se produire :

       Erreur de domaine : x est negatif et y est un nombre fini non entier
              errno  prend la valeur EDOM. Une exception indiquant une virgule
              flottante incorrecte (FE_INVALID) est levee.

       Erreur de pole : x est nul et y est negatif
              errno est configure  a  la  valeur  ERANGE  (mais  consultez  la
              section   des   BOGUES).  Une  exception  de  virgule  flottante
              divide-by-zero (FE_DIVBYZERO).

       Erreur d'intervalle : depassement pour le resultat
              errno est configuree a ERANGE. Une exception de  depassement  en
              virgule flottante (FE_OVERFLOW) est levee.

       Erreur d'intervalle : soupassement (<< underflow >>) du resultat
              errno prend la valeur ERANGE. Une exception en virgule flottante
              de soupassement (FE_UNDERFLOW) est levee.

CONFORMIT'E

       C99, POSIX.1-2001.  La  variante  renvoyant  un  double  est  egalement
       conforme a SVr4, BSD 4.3 et C89.

BOGUES

       Dans  la  glibc  2.9 et les versions anterieures, si une erreur de pole
       survient, errno est positionne a EDOM a la place de  la  valeur  ERANGE
       specifiee  par  POSIX.  Depuis  la  version 2.10, le comportement de la
       glibc est corrige.

       Si x est negatif, alors des valeurs negatives ou positives  importantes
       de  y  provoquent  un  NaN  comme  resultat  de la fonction, avec errno
       prenant la valeur EDOM et une exception de virgule flotante  incorrecte
       (FE_INVALID).   Par   exemple,   avec  pow(),  on  peut  rencontrer  ce
       comportement quand la valeur absolue de  y  est  superieure  a  environ
       9,223373e18.

       Dans la version 2.3.2 et les suivante de la glibc, quand un depassement
       ou un soupassement (<< underflow >>) se produit, pow()  genere  a  tort
       une  exception  de virgule flottante incorrecte (FE_INVALID) en plus de
       l'exception de depassement ou de soupassement.

VOIR AUSSI

       cbrt(3), cpow(3), sqrt(3)

COLOPHON

       Cette page fait partie de  la  publication  3.27  du  projet  man-pages
       Linux.  Une description du projet et des instructions pour signaler des
       anomalies      peuvent      etre       trouvees       a       l'adresse
       <URL:http://www.kernel.org/doc/man-pages/>.

TRADUCTION

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

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

       Veuillez  signaler  toute  erreur   de   traduction   en   ecrivant   a
       <debian-l10n-french@lists.debian.org> ou par un rapport de bogue sur le
       paquet manpages-fr.

       Vous pouvez toujours avoir acces a la version anglaise de  ce  document
       en utilisant la commande << man -L C <section> <page_de_man> >>.

                               12 septembre 2010                        POW(3)