Provided by:
manpages-fr-dev_3.27fr1.4-1_all 
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)