bcpow

bcpow(string $num, string $exponent, [int $scale]): string
```php

Eleva `num` a la potencia `exponent`.

## Parámetros

`num`  
La base, como un string.

`exponent`  
El exponente, como un string. Debe ser un valor sin parte fraccionaria. El rango válido del exponente es específico de la plataforma, pero es al menos de `-2147483648` a `2147483647`.

## Valores devueltos

Devuelve el resultado como un string.

## Errores/Excepciones

Esta función lanza una ValueError en los siguientes casos: `num` o `exponent` no es un string numérico con formato válido de BCMath, `exponent` tiene una parte fraccionaria, `exponent` o `scale` están fuera del rango válido

Esta función lanza una DivisionByZeroError si `num` es `0` y `exponent` es un valor negativo.

## Historial de cambios

| Versión | Descripción |
|----|----|
| 8.4.0 | Las potencias negativas de `0` anteriormente devolvían `0`, pero ahora lanzan una excepción DivisionByZeroError. |
| 8.0.0 | Cuando `exponent` tiene una parte fraccionaria, ahora lanza un ValueError en lugar de truncar. |
| 7.3.0 | `bcpow` ahora devuelve números con la escala solicitada. Anteriormente, los números devueltos podían omitir los ceros decimales finales. |

## Ejemplos

Ejemplo de `bcpow`