(PHP 4, PHP 5, PHP 7, PHP 8)
array_pad — Complète un tableau avec une valeur jusqu'à la longueur spécifiée
array_pad() retourne une copie du tableau
array complétée jusqu'à la taille de
length avec la valeur
value. Si
length est positif, alors le tableau
est complété à droite, s'il est négatif, il est complété à gauche.
Si la valeur absolue de length est plus
petite que la taille du tableau array,
alors le tableau n'est pas complété.
Il est possible d'ajouter au maximum 1048576 éléments d'un seul coup.
arrayTableau initial de valeurs à compléter.
lengthNouvelle taille du tableau.
value
Valeur à insérer si l'argument array
est plus petit que l'argument length.
Retourne une copie du tableau
array complétée jusqu'à la taille de
length avec la valeur
value. Si
length est positif, alors le tableau
est complété à droite, s'il est négatif, il est complété à gauche.
Si la valeur absolue de length est plus
petite que la taille du tableau array,
alors le tableau n'est pas complété.
Exemple #1 Exemple avec array_pad()
<?php
$input = array(12, 10, 9);
$result = array_pad($input, 5, 0);
// Le résultat est : array(12, 10, 9, 0, 0)
$result = array_pad($input, -7, -1);
// Le résultat est : array(-1, -1, -1, -1, 12, 10, 9)
$result = array_pad($input, 2, "noop");
// pas complété
?>