pow

(PHP 4, PHP 5, PHP 7, PHP 8)

powВозводит в степень

Описание

pow(mixed $num, mixed $exponent): int|float|object

Функция возвращает число 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

?>

Примечания

Замечание:

Функция преобразовывает входные данные в числа, даже нескалярные значения, что иногда даёт странные результаты.

Смотрите также

  • exp() - Вычисляет степень числа e
  • sqrt() - Извлекает квадратный корень
  • bcpow() - Возведение в степень чисел с произвольной точностью
  • gmp_pow() - Возводит число в степень