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-модули иногда переопределяют поведение операции и заставляют её возвращать объект.

Список изменений

Версия Описание
8.4.0 Передача в аргументе exponent отрицательного значения для возведения 0 в отрицательную степень устарела.

Примеры

Пример #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

?>

Примечания

Замечание:

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

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

  • ** — Оператор возведения в степень
  • fpow() - Возводит число в степень по правилам стандарта IEEE 754
  • exp() - Вычисляет степень числа e
  • sqrt() - Извлекает квадратный корень
  • bcpow() - Возводит в степень число произвольной точности
  • gmp_pow() - Возводит число в степень