gmp_powm
PHP function
Edit on GitHub ✎
(PHP 4 >= 4.0.4, PHP 5, PHP 7, PHP 8)
Raise number into power with modulo
Description
gmp_powm(GMP|int|string $num, GMP|int|string $exponent, GMP|int|string $modulus): GMP
Calculate (num raised into power exponent) modulo modulus.
Parameters
numThe base number.
Parameter
exponentThe positive power to raise the
num.Parameter
modulusThe modulo.
Parameter
Return Values
The new (raised) number, as a GMP number.
Errors/Exceptions
Throws a ValueError if exponent is negative.
Throws a DivisionByZeroError if modulus is 0.
Prior to PHP 8.0.0, an E_WARNING was raised instead.
Examples
gmp_powm() example
php
<?php
$pow1 = gmp_powm("2", "31", "2147483649");
echo gmp_strval($pow1) . "\n";
?>The above example will output:
output
2147483648