array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'function.array-fill.php', 1 => 'array_fill', ), 'up' => array ( 0 => 'ref.array.php', 1 => 'Fonctions sur les tableaux', ), 'prev' => array ( 0 => 'function.array-fill-keys.php', 1 => 'array_fill_keys', ), 'next' => array ( 0 => 'function.array-filter.php', 1 => 'array_filter', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'fr', 'path' => 'reference/array/functions/array-fill.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)
array_fill — Remplit un tableau avec une même valeur
Crée un tableau avec count
entrées, toutes de valeur
value
. Les index commencent à la valeur
start_index
.
start_index
Le premier index du tableau retourné.
Si start_index
est négatif,
le premier index du tableau retourné sera
start_index
, suivi par des indices commençant à
zéro dans les versions antérieur à PHP 8.0.0 ;
à partir de PHP 8.0.0, les indices négatifs sont incrémentés normalement.
(voir l'exemple).
count
Nombre d'éléments à insérer.
Doit être supérieur ou égal à zéro, et inférieur ou égal à 2147483647
.
value
Valeur à utiliser pour remplir le tableau
Retourne le tableau rempli.
Lance une exception ValueError si
count
est en dehors de la plage permise.
Version | Description |
---|---|
8.0.0 |
La fonction array_fill() lance désormais une ValueError
si count est en dehors de la plage permise ;
auparavant une alerte de niveau E_WARNING était émise, et la fonction retournait false .
|
Exemple #1 Exemple avec array_fill()
<?php
$a = array_fill(5, 6, 'banana');
print_r($a);
?>
L'exemple ci-dessus va afficher :
Array ( [5] => banana [6] => banana [7] => banana [8] => banana [9] => banana [10] => banana )
Exemple #2 Exemple de array_fill() avec un indice de départ négatif
<?php
$a = array_fill(-2, 4, 'pear');
print_r($a);
?>
Résultat de l'exemple ci-dessus en PHP 7 :
Array ( [-2] => pear [0] => pear [1] => pear [2] => pear )
Résultat de l'exemple ci-dessus en PHP 8 :
Array ( [-2] => pear [-1] => pear [0] => pear [1] => pear )
Notez que l'indice -1
n'est pas présent antérieurement à PHP 8.0.0.
Voir aussi la section du manuel sur les tableaux pour plus d'informations sur les clés négatives.