gmp_powm

gmp_powm(GMP $num, GMP $exponent, GMP $modulus): GMP
```php

Calcula la (`num` elevada a la potencia `exponent`) con modulo `modulus`. Si `exponent` es negativo, el resultado es indefinido.

## Parámetros

`num`  
La base del número.

Un objeto `GMP`, un `int`, o un `string` que puede ser interpretado como un número siguiendo la misma lógica que si la cadena fuera usada en `gmp_init` con detección automática de la base (es decir cuando `base` es igual a 0).

`exponent`  
La potencia positiva a elevar la `num`.

Un objeto `GMP`, un `int`, o un `string` que puede ser interpretado como un número siguiendo la misma lógica que si la cadena fuera usada en `gmp_init` con detección automática de la base (es decir cuando `base` es igual a 0).

`modulus`  
El modulo.

Un objeto `GMP`, un `int`, o un `string` que puede ser interpretado como un número siguiendo la misma lógica que si la cadena fuera usada en `gmp_init` con detección automática de la base (es decir cuando `base` es igual a 0).

## Valores devueltos

El nuevo (elevado) número, como un número GMP.

## Ejemplos

Ejemplo de `gmp_powm`

2147483648