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.