Funzione array_pad

La funzione array_pad completa un array con un valore specifico fino a una dimensione data. Il primo parametro della funzione è l'array da completare, il secondo parametro è la dimensione desiderata, il terzo è il valore con cui riempire.

Il secondo parametro può essere negativo - in questo caso l'array verrà completato con elementi all'inizio e non alla fine.

Sintassi

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

Esempio

Completiamo un array con zeri in modo che la sua dimensione diventi 7 elementi:

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

Risultato dell'esecuzione del codice:

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

Esempio

Ora l'array ha già 7 elementi - quindi non verrà completato con nulla:

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

Risultato dell'esecuzione del codice:

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

Esempio

Rendiamo negativo il secondo parametro. In questo caso l'array verrà completato all'inizio, e non alla fine:

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

Risultato dell'esecuzione del codice:

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

Vedi anche

  • la funzione array_fill,
    che riempie un array con un valore dato
  • la funzione range,
    che crea un array con un intervallo di elementi