array_pad

array_pad(array $array, int $length, mixed $value): array
```php

`array_pad` devuelve una copia del array `array` completado hasta el tamaño de `length` con el valor `value`. Si `length` es positivo, entonces el array se completa a la derecha, si es negativo, se completa a la izquierda. Si el valor absoluto de `length` es más pequeño que el tamaño del array `array`, entonces el array no se completa.

## Parámetros

`array`  
Array inicial de valores a completar.

`length`  
Nueva longitud del array.

`value`  
Valor a insertar si el argumento `array` es más pequeño que el argumento `length`.

## Valores devueltos

Devuelve una copia del array `array` completado hasta el tamaño de `length` con el valor `value`. Si `length` es positivo, entonces el array se completa a la derecha, si es negativo, se completa a la izquierda. Si el valor absoluto de `length` es más pequeño que el tamaño del array `array`, entonces el array no se completa.

## Historial de cambios

| Versión | Descripción |
|----|----|
| 8.3.0 | Antes de la versión 8.3, solo podían añadirse 1048576 elementos a la vez. Ahora, esto está limitado únicamente por el tamaño máximo de un array. |

## Ejemplos

Ejemplo con `array_pad`