pow

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

powPotência

Descrição

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

Retorna a num elevada ao exponente exponent.

Nota:

É possível usar o operador **.

Parâmetros

num

O valor base

exponent

O exponente

Valor Retornado

num exponenciado ao valor de exponent. Se ambos os valores não forem negativos e o resultado puder ser representado como um inteiro, o resultado retornado será do tipo int, e em outros casos será retornado como um float.

Exemplos

Exemplo #1 Alguns exemplos de pow()

<?php

var_dump
(pow(2, 8)); // int(256)
echo pow(-1, 20); // 1
echo pow(0, 0); // 1
echo pow(10, -1); // 0.1

echo pow(-1, 5.5); // NAN
?>

Notas

Nota:

Esta função converterá todos os tipos para números, mesmo valores não escalares, o que pode levar a resultados esquisitos.

Veja Também

  • exp() - Calcula o expoente de e
  • sqrt() - Raiz quadrada
  • bcpow() - Eleva um número de precisão arbitrária a outro
  • gmp_pow() - Potenciação

add a note

User Contributed Notes 6 notes

up
49
chris at ocportal dot com
11 years ago
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.
up
17
raiika
5 years ago
It is official now that you could use

<?php

2
** 3; // 8

// instead of

pow(2, 3); // 8

?>
up
11
gilthansREMOVEME at gmail dot com
16 years ago
Note that pow(0, 0) equals to 1 although mathematically this is undefined.
up
2
Roman
2 years ago
If you use negative numbers, you need to use brackets for using with **

<?php

-1 ** 2; // -1

(-1) ** 2; // 1

?>
up
-1
scott at arciszewski dot me
9 years ago
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);
?>
up
-6
jaxx1rr at gmail dot com
4 years ago
funny thing

number_format(pow(2, 1023));
gives a long number

but number_format(pow(2, 1024));
gives inf
To Top