bcpowmod

(PHP 5, PHP 7)

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

Descrição

bcpowmod ( string $left_operand , string $right_operand , string $modulus [, int $scale = 0 ] ) : string

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

Parâmetros

left_operand

O operando da esquerda, do tipo string.

right_operand

O operando da direita, do tipo string.

modulus

O módulo, do tipo string.

scale

Este parâmetro opcional é utilidazado para configurar o número de dígitos na parte fracionária do resultado. Se omitido será utilizada a escala padrão globalmente configurada com a função bcscale(), com padrão de fábrica em 0 se não configurado.

Valor Retornado

Retorna um string com resultado ou NULL se modulus for 0.

Notas

Nota:

Por que esse método usa a operação de módulo, números não positivos podem gerar resultados inesperados.

Exemplos

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.

?>

Veja Também

  • bcpow() - Eleva um número de precisão arbitrária a outro
  • bcmod() - Obtém o módulo de um número com precisão arbitrária