(PHP 4, PHP 5, PHP 7, PHP 8)
array_pad — Completa un array con un valor hasta la longitud especificada
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.
arrayArray inicial de valores a completar.
lengthNuevo tamaño del array.
value
Valor a insertar si el argumento array
es más pequeño que el argumento length.
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.
| Versión | Descripción |
|---|---|
| 8.3.0 | Antes de la versión 8.3, solo 1048576 elementos podían ser añadidos de una sola vez. Ahora, esto está limitado únicamente por el tamaño máximo de un array. |
Ejemplo #1 Ejemplo con array_pad()
<?php
$input = array(12, 10, 9);
$result = array_pad($input, 5, 0);
// El resultado es: array(12, 10, 9, 0, 0)
$result = array_pad($input, -7, -1);
// El resultado es: array(-1, -1, -1, -1, 12, 10, 9)
$result = array_pad($input, 2, "noop");
// no completado
?>