array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'function.array-pad.php', 1 => 'array_pad', ), 'up' => array ( 0 => 'ref.array.php', 1 => 'Fonctions sur les tableaux', ), 'prev' => array ( 0 => 'function.array-multisort.php', 1 => 'array_multisort', ), 'next' => array ( 0 => 'function.array-pop.php', 1 => 'array_pop', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'fr', 'path' => 'reference/array/functions/array-pad.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(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é
?>