(PHP 4, PHP 5, PHP 7, PHP 8)
pow — Expression exponentielle
Retourne num élevé à la puissance
exponent.
Note:
Il est possible d'utiliser l'opérateur ** à la place.
numLa base à utiliser
exponentL'exposent
num élevé à la puissance exponent.
Si les arguments ne sont pas des entiers négatifs, et que le résultat
peut être représenté sous la forme d'un entier, le résultat sera
entier, sinon s'il sera retourné en tant que nombre décimal.
Les extensions PHP peuvent remplacer le comportement de cette opération et la faire retourner un objet.
| Version | Description |
|---|---|
| 8.4.0 |
Élever 0 à une
exposant négatif est désormais obsolète.
|
Exemple #1 Exemple avec pow()
<?php
var_dump(pow(2, 8)); // int(256)
echo pow(-1, 20), PHP_EOL; // 1
echo pow(0, 0), PHP_EOL; // 1
echo pow(10, -1), PHP_EOL; // 0.1
var_dump(pow(new GMP("3"), new GMP("2"))); // object(GMP)
echo pow(-1, 5.5); // NAN
?>Note:
Cette fonction convertira toutes les entrées en un nombre, y compris pour les valeurs non-scalaires, ce qui peut amener à des résultats imprévisibles.
Many notations use "^" as a power operator, but in PHP (and other C-based languages) that is actually the XOR operator. You need to use this 'pow' function, there is no power operator.
i.e. 3^2 means "3 XOR 2" not "3 squared".
It is particular confusing as when doing Pythagoras theorem in a 'closet points' algorithm using "^" you get results that look vaguely correct but with an error.It is official now that you could use
<?php
2 ** 3; // 8
// instead of
pow(2, 3); // 8
?>Note that pow(0, 0) equals to 1 although mathematically this is undefined.If you use negative numbers, you need to use brackets for using with **
<?php
-1 ** 2; // -1
(-1) ** 2; // 1
?>As of PHP 5.6.0alpha2, there is now an exponentiation operator. If this is kept in the final release, it may be worth noting here.
<?php
// These two will be equivalent as of PHP 5.6.0
$x = $y ** 2;
$x = pow($y, 2);
?>