pow(3) Library Functions Manual pow(3)
NOM
pow, powf, powl - Fonctions puissance
BIBLIOTHÈQUE
Bibliothèque de math (libm, -lm)
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);
Exigences de macros de test de fonctionnalités pour la glibc (consulter
feature_test_macros(7)) :
powf(), powl() :
_ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
|| /* Depuis la glibc 2.19 : */ _DEFAULT_SOURCE
|| /* glibc <= 2.19 : */ _BSD_SOURCE || _SVID_SOURCE
DESCRIPTION
Ces fonctions renvoient la valeur de x élevée à la puissance y.
VALEUR RENVOYÉE
En cas de réussite, ces fonctions renvoient la valeur de x élevée à la
puissance y.
En cas de dépassement pour le résultat, une erreur d'intervalle se pro-
duit et les fonctions renvoient respectivement HUGE_VAL, HUGE_VALF ou
HUGE_VALL, avec le bon signe mathématique.
If result underflows, and is not representable, a range error occurs,
and 0.0 with the appropriate sign is returned.
Si x vaut +0 ou -0 et y est un nombre entier impair négatif, une erreur
de pôle se produit et HUGE_VAL, HUGE_VALF ou HUGE_VALL est renvoyé avec
le même signe que x.
Si x vaut +0 ou -0 et y est négatif et pas un nombre impair, une erreur
de pôle se produit et +HUGE_VAL, +HUGE_VALF ou +HUGE_VALL est renvoyé.
Si x vaut +0 (resp. -0) et y est un nombre entier impair positif, le
résultat est +0 (resp. -0).
Si x est nul et y positif et n'est pas un nombre entier impair, le ré-
sultat est +0.
Si x vaut -1 et y est une valeur infinie positive ou négative, le ré-
sultat est 1,0.
Si x vaut +1, le résultat est 1,0 (même si y est un NaN).
Si y est nul, le résultat est 1,0 (même si x est un NaN).
Si x est une valeur finie négative et y un nombre fini non entier, une
erreur de domaine se produit et un NaN est renvoyé.
Si la valeur absolue de x est inférieure à 1 et y est une valeur infi-
nie négative, le résultat est l'infini positif.
Si la valeur absolue de x est supérieure à 1 et y est une valeur infi-
nie négative, le résultat est +0.
Si la valeur absolue de x est inférieure à 1 et y est une valeur infi-
nie positive, le résultat est +0.
Si la valeur absolue de x est supérieure à 1 et y est une valeur infi-
nie positive, le résultat est l'infini positif.
Si x est une valeur infinie négative et y est un nombre entier impair
négatif, le résultat est -0.
Si x est une valeur infinie négative et y est négatif et n'est pas un
nombre entier impair, le résultat est +0.
Si x est une valeur infinie négative et y est un nombre entier impair
positif, le résultat est l'infini négatif.
Si x est une valeur infinie négative et y est positif et n'est pas un
nombre entier impair, le résultat est l'infini positif.
Si x est une valeur infinie positive et y est négatif, le résultat est
+0.
Si x est une valeur infinie positive et y est positif, le résultat est
l'infini positif.
Except as specified above, if x or y is a NaN, the result is a NaN.
ERREURS
Voir math_error(7) pour savoir comment déterminer si une erreur s'est
produite lors de l'appel d'une de ces fonctions.
Les erreurs suivantes peuvent se produire :
Erreur de domaine : x est négatif et y est un nombre fini non entier
errno prend la valeur EDOM. Une exception de virgule flottante
non valable (FE_INVALID) est levée.
Erreur de pôle : x est nul et y est négatif
errno est configuré à la valeur ERANGE (mais consultez la sec-
tion BOGUES). Une exception de virgule flottante divisée par
zéro (FE_DIVBYZERO) est déclenchée.
Erreur d'intervalle : dépassement pour le résultat
errno est configurée à ERANGE. Une exception de dépassement par
le haut de virgule flottante (FE_OVERFLOW) est levée.
Erreur d'intervalle : soupassement (« underflow ») du résultat
errno prend la valeur ERANGE. Une exception de dépassement par
le bas de virgule flottante (FE_UNDERFLOW) est levée.
ATTRIBUTS
Pour une explication des termes utilisés dans cette section, consulter
attributes(7).
┌─────────────────────────────────────┬──────────────────────┬─────────┐
│Interface │ Attribut │ Valeur │
├─────────────────────────────────────┼──────────────────────┼─────────┤
│pow(), powf(), powl() │ Sécurité des threads │ MT-Safe │
└─────────────────────────────────────┴──────────────────────┴─────────┘
STANDARDS
C99, POSIX.1-2001, POSIX.1-2008.
La variante renvoyant double est également conforme à SVr4, 4.3BSD.
BOGUES
Historical bugs (now fixed)
Before glibc 2.28, on some architectures (e.g., x86-64) pow() may be
more than 10,000 times slower for some inputs than for other nearby in-
puts. This affects only pow(), and not powf() nor powl(). This problem
was fixed in glibc 2.28.
A number of bugs in the glibc implementation of pow() were fixed in
glibc 2.16.
In glibc 2.9 and earlier, when a pole error occurs, errno is set to
EDOM instead of the POSIX-mandated ERANGE. Since glibc 2.10, glibc does
the right thing.
In glibc 2.3.2 and earlier, when an overflow or underflow error occurs,
glibc's pow() generates a bogus invalid floating-point exception
(FE_INVALID) in addition to the overflow or underflow exception.
VOIR AUSSI
cbrt(3), cpow(3), sqrt(3)
TRADUCTION
La traduction française de cette page de manuel a été créée par Chris-
tophe Blaess <https://www.blaess.fr/christophe/>, Stéphan Rafin <ste-
phan.rafin@laposte.net>, Thierry Vignaud <tvignaud@mandriva.com>, Fran-
çois Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe Gué-
rard <fevrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-luc.cou-
lon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas Huriaux
<thomas.huriaux@gmail.com>, Nicolas François <nicolas.francois@centra-
liens.net>, Florentin Duneau <fduneau@gmail.com>, Simon Paillard <si-
mon.paillard@resel.enst-bretagne.fr>, Denis Barbier <barbier@de-
bian.org>, David Prévot <david@tilapin.org>, Cédric Boutillier <ce-
dric.boutillier@gmail.com> et Jean-Philippe MENGUAL <jpmengual@de-
bian.org>
Cette traduction est une documentation libre ; veuillez vous reporter à
la GNU General Public License version 3
⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ concernant les conditions
de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.
Si vous découvrez un bogue dans la traduction de cette page de manuel,
veuillez envoyer un message à ⟨debian-l10n-french@lists.debian.org⟩.
Pages du manuel de Linux 6.03 5 février 2023 pow(3)
Generated by dwww version 1.15 on Sat Jun 29 01:41:11 CEST 2024.