(PHP 4, PHP 5, PHP 7, PHP 8)
pow — Возводит в степень
Функция возвращает число num в степени exponent.
Замечание:
Вместо вызова функции указывают оператор **.
numОснование.
exponentПоказатель степени.
Функция возвращает основание num в степени exponent.
Функция возвращает целое число (int), если оба аргумента —
неотрицательные целые числа и функция сумеет представить результат как целое число,
иначе функция возвращает число с плавающей точкой (float).
PHP-модули иногда переопределяют поведение операции и заставляют её возвращать объект.
Пример #1 Примеры использования функции 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
?>Замечание:
Функция преобразовывает входные данные в числа, даже нескалярные значения, что иногда даёт странные результаты.
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);
?>