(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.
lengthNueva longitud 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 podían añadirse 1048576 elementos a la 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)
echo join(', ', $result), PHP_EOL;
$result = array_pad($input, -7, -1);
// El resultado es : array(-1, -1, -1, -1, 12, 10, 9)
echo join(', ', $result), PHP_EOL;
$result = array_pad($input, 2, "noop");
// no se completa
echo join(', ', $result), PHP_EOL;
?>