(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é.
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é.
| Version | Description |
|---|---|
| 8.3.0 | Avant la version 8.3, seuls 1048576 éléments pouvaient être ajoutés en une seule fois. Maintenant, cela est limité uniquement par la taille maximale d'un tableau. |
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é
?>