# 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é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

### 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
    )

Notez 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

- array_fill_keys() - Remplit un tableau avec des valeurs, en spécifiant les clés
- str_repeat() - Répète une chaîne
- range() - Crée un tableau contenant un intervalle d'éléments