bcpow
bcscale
BC Math Funções
PHP Manual

# bcpowmod

(PHP 5)

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

### Descrição

string bcpowmod ( string `$left_operand` , string `$right_operand` , string `$modulus` [, int `$scale` ] )

Use 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 é usado para definir o número de digitos depois do ponto decimal no resultado. Você pode definir a escala padrão global para todas as funções usando bcscale().

### 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-naturais pode dar resultados inexperados. Um número natural é qualquer inteiro positivo diferente de zero.

### 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 and $b are equal to each other.
?>`

### Veja Também

- bcpow() - Elevar 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

bcpow
bcscale
BC Math Funções
PHP Manual