Eleva um número de precisão arbitrária a outro

Descrição

bcpow(string $num, string $exponent, ?int $scale = null): string

Eleva num a potência de exponent.

Parâmetros

num: O número base, como uma string.
exponent: O número expoente, como uma string. Se o expoente for não inteiro, ele será truncado. Os expoentes válidos dependem da plataforma, mas ao menos são válidos de -2147483648 até 2147483647.
scale: Este parâmetro opcional é usado para definir o número de dígitos após a casa decimal do resultado. Se omitido, o padrão será a escala definida globalmente com a função bcscale() ou, em último caso, 0 se a escala não tiver sido definida.

Valor Retornado

Retorna o resultado como uma string.

Registro de Alterações

Versão	Descrição
7.3.0	bcpow() agora retorna números com a escala solicitada. Mais exatamente, o número retornado pode omitir alguns zeros decimais.

Exemplos

Example #1 Exemplo da bcpow()

<?php

echo bcpow('4.2', '3', 2); // 74.08

?>

Notas

Note:
Anteriormente ao PHP 7.3.0, bcpow() podia retornar um resultado com menos dígitos decimais do que o indicado no parâmetro scale. Isto ocorre quando o resultado não requer toda a precisão permitida por scale. Por exemplo:
Example #2 Exemplo bcpow() com scale
<?php
echo bcpow('5', '2', 2);     // Imprime "25", não "25.00"
?>

Veja Também

bcpowmod() - Eleva um número de precisão arbitrária para outro, reduzido por um módulo especificado
bcsqrt() - Obtém a raiz quadrada de um número de precisão arbitrária