gmp_powm

(PHP 4 >= 4.0.4, PHP 5, PHP 7, PHP 8)

gmp_powmEleva um número a uma potência com módulo

Descrição

gmp_powm(GMP|int|string $num, GMP|int|string $exponent, GMP|int|string $modulus): GMP

Calcula o resto da divisão de (num elevado à potência exponent) por modulus. Se exponent for negativo, o resultado é indefinido.

Parâmetros

num

O número da base.

Um objeto GMP, um int ou uma string numérica.

exponent

A potência positiva à qual num será elevado.

Um objeto GMP, um int ou uma string numérica.

modulus

O divisor para obtenção do resto (módulo).

Um objeto GMP, um int ou uma string numérica.

Valor Retornado

O novo número (exponenciado), como um número GMP.

Exemplos

Example #1 Exemplo de gmp_powm()

<?php
$pow1 = gmp_powm("2", "31", "2147483649");
echo gmp_strval($pow1) . "\n";
?>

O exemplo acima produzirá:

2147483648