array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'function.array-fill.php', 1 => 'array_fill', 2 => 'Remplit un tableau avec une même valeur', ), 'up' => array ( 0 => 'ref.array.php', 1 => 'Fonctions sur les tableaux', ), 'prev' => array ( 0 => 'function.array-diff-ukey.php', 1 => 'array_diff_ukey', ), 'next' => array ( 0 => 'function.array-fill-keys.php', 1 => 'array_fill_keys', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'fr', 'path' => 'reference/array/functions/array-fill.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

array_fill

(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)

array_fill — Remplit un tableau avec une même valeur

Description

array_fill(int $start_index, int $count, mixed $value): array

Crée un tableau avec count entrées, toutes de valeur value. Les index commencent à la valeur start_index.

Liste de paramètres

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érieures à 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

Valeurs de retour

Retourne le tableau rempli.

Erreurs / Exceptions

Lance une exception ValueError si count est en dehors de la plage permise.

Historique

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.

Exemples

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 8 :

Array
(
    [-2] => pear
    [-1] => pear
    [0] => pear
    [1] => pear
)

Résultat de l'exemple ci-dessus en PHP 7 :

Array
(
    [-2] => pear
    [0] => pear
    [1] => pear
    [2] => pear
)

Il est à noter que l'indice -1 n'est pas présent antérieurement à PHP 8.0.0.

Notes

Voir aussi la section du manuel sur les tableaux pour plus d'informations sur les clés négatives.

Voir aussi