bcpowmod

(PHP 5, PHP 7, PHP 8)

bcpowmod — Eleva um número de precisão arbitrária para outro, reduzido por um módulo especificado

function bcpowmod(
    string $num,
    string $exponent,
    string $modulus,
    ?int $scale = null
): string

Utiliza o método de exponenciação rápida para elevar num à potência exponent levando em conta o módulo modulus.

num: A base, na forma de inteiro em string (a escala tem que ser zero).
exponent: O expoente, na forma de um inteiro não negativo, em string (a escala tem que ser zero).
modulus: O módulo, na forma de um inteiro em string (a escala tem que ser zero).
scale: Este parâmetro é usado para definir o número de dígitos após o separador de decimais do resultado. Se for null, será usada a escala padrão definida com bcscale(), ou será usado o valor da diretiva INI bcmath.scale.

Retorna o resultado como uma string.

Esta função lança uma exceção ValueError nos seguintes casos:

Esta função lança uma exceção DivisionByZeroError se modulus for igual a 0.

Versão	Descrição
8.0.0	`scale` agora pode ser nulo.
8.0.0	Agora lança uma exceção ValueError ao invés de retornar `false` se `exponent` for negativo.
8.0.0	Dividir por `0` agora lança uma exceção DivisionByZeroError ao invés de retornar `false`.

As seguintes instruções têm funcionalidades idênticas. A versão bcpowmod(), no entanto, executa em menos tempo e pode aceitar parâmetros maiores.

<?php
$a = bcpowmod($x, $y, $mod);

$b = bcmod(bcpow($x, $y), $mod);

// $a e $b são iguais.

?>

Nota:
Por esse método realizar operações em módulo, números que não sejam inteiros positivos podem gerar resultados inesperados.

bcpow() - Eleva um número de precisão arbitrária a outro
bcmod() - Obtém o resto de uma divisão com precisão arbitrária
BcMath\Number::powmod() - Eleva um número de precisão arbitrária, reduzido por um módulo especificado