Функция array_pad

La función array_pad complementa un array con un valor específico hasta un tamaño determinado. El primer parámetro de la función acepta el array a rellenar, el segundo parámetro - hasta qué tamaño llenar, el tercero - con qué llenar.

El segundo parámetro puede ser negativo - en este caso el array se complementará con elementos no desde el final, sino desde el principio.

Sintaxis

phparray_pad(array $array, int $length, mixed $value): array

Ejemplo

Vamos a llenar el array con ceros para que su tamaño sea de 7 elementos:

php<?php
  $arr = ['a', 'b', 'c', 'd', 'e'];
  
  $res = array_pad($arr, 7, 0);
  var_dump($res);
?>

Resultado de ejecutar el código:

php['a', 'b', 'c', 'd', 'e', 0, 0]

Ejemplo

Y ahora el array ya tiene 7 elementos - por lo tanto no se llenará con nada:

php<?php
  $arr = ['a', 'b', 'c', 'd', 'e', 'f', 'g'];
  
  $res = array_pad($arr, 7, 0);
  var_dump($res);
?>

Resultado de ejecutar el código:

php['a', 'b', 'c', 'd', 'e', 'f', 'g']

Ejemplo

Hagamos que el segundo parámetro sea negativo. En este caso el array se llenará desde el principio, y no desde el final:

php<?php
  $arr = ['a', 'b', 'c', 'd', 'e'];
  
  $res = array_pad($arr, -7, 0);
  var_dump($res);
?>

Resultado de ejecutar el código:

php[0, 0, 'a', 'b', 'c', 'd', 'e']

Véase también

  • la función array_fill,
    que llena un array con un valor dado
  • la función range,
    que crea un array con un rango de elementos