array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.bcpow.php', 1 => 'bcpow', ), 'up' => array ( 0 => 'ref.bc.php', 1 => 'BC Math Funções', ), 'prev' => array ( 0 => 'function.bcmul.php', 1 => 'bcmul', ), 'next' => array ( 0 => 'function.bcpowmod.php', 1 => 'bcpowmod', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/bc/functions/bcpow.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 4, PHP 5, PHP 7, PHP 8)
bcpow — Eleva um número de precisão arbitrária a outro
Eleva num
a potência de
exponent
.
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.
Retorna o resultado como uma string.
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. |
Exemplo #1 Exemplo da bcpow()
<?php
echo bcpow('4.2', '3', 2); // 74.08
?>
Nota:
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 porscale
. Por exemplo:Exemplo #2 Exemplo bcpow() com scale
<?php
echo bcpow('5', '2', 2); // Imprime "25", não "25.00"
?>