array_pad
(PHP 4, PHP 5)
array_pad — Rellena un array a la longitud especificada con un valor
Descripción
array_pad() devuelve una copia de
array rellenada al tamaño especificado por
size con el valor
value. Si
size es positivo, el array se
rellena hacia la derecha, si es negativo hacia la izquierda. Si el
valor absoluto de size es menor o
igual a la longitud de array, no se lleva
a cabo el relleno.
Es posible añadir como máximo 1048576 elementos de una sola vez.
Parámetros
-
array -
Array inicial de valores a rellenar.
-
size -
Nuevo tamaño del array.
-
value -
Valor a rellenar si
arrayes menor quesize.
Valores devueltos
Devuelve una copia de array rellenada al espacio especificado
por size con el valor
value. Si size es
positivo el array es relleno hacia la derecha, si es negativo
hacia la izquierda. Si el valor absoluto de size es
menor o igual que la longitud de array, no se lleva a cabo
el relleno.
Ejemplos
Ejemplo #1 Ejemplo de 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");
// sin relleno
?>
Ver también
- array_fill() - Llena un array con valores
- range() - Crear un array que contiene un rango de elementos