(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é.
array
Tableau initial de valeurs à compléter.
length
Nouvelle 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é
?>