(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.
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
.
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;
?>