array_pad

(PHP 4, PHP 5, PHP 7)

array_padRellena un array a la longitud especificada con un valor

Descripción

array_pad ( array $array , int $size , mixed $value ) : array

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 array es menor que size.

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(12109);

$result array_pad($input50);
// 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($input2"noop");
// sin relleno
?>

Ver también

  • array_fill() - Llena un array con valores
  • range() - Crear un array que contiene un rango de elementos