pow

pow(mixed $num, mixed $exponent): int
```php

Devuelve `num` elevado a la potencia `exponent`.

> [!NOTE]
> Es posible utilizar el operador [\*\*](#language.operators.arithmetic) en su lugar.

## Parámetros

`num`  
La base a utilizar

`exponent`  
El exponente

## Valores devueltos

`num` elevado a la potencia `exponent`. Si los argumentos no son enteros negativos, y el resultado puede ser representado como un entero, el resultado será `int`, de lo contrario será devuelto como `float`.

Las extensiones PHP pueden reemplazar el comportamiento de esta operación y hacer que devuelva un objeto.

## Historial de cambios

| Versión | Descripción                                             |
|---------|---------------------------------------------------------|
| 8.4.0   | Elevar `0` a un `exponente` negativo es ahora obsoleto. |

## Ejemplos

Ejemplo con `pow`

Ejemplos de `pow` con un objeto de la extensión GMP