# array_fill

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

array_fill — Füllt ein Array mit Werten

### Beschreibung

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

array_fill() füllt ein Array mit `count` Einträgen mit dem Wert des Parameters `value`. Die Indizes des Arrays beginnen mit dem Parameter `start_index`.

### Parameter-Liste

`start_index`

  Der erste Index des zurückgegebenen Arrays.

  Wenn `start_index` negativ ist, ist der erste Index des zurückgebenen Arrays `start_index` und die folgenden Indizes beginnen vor PHP 8.0.0 bei Null; seit PHP 8.0.0 werden negative Indizes normal hochgezählt (siehe Beispiel).

`count`

  Anzahl der einzufügenden Elemente. Muss größer oder gleich 0 und kleiner oder gleich `2147483647` sein.

`value`

  Einzufügender Wert

### Rückgabewerte

Gibt das gefüllte Array zurück

### Fehler/Exceptions

Wenn `count` außerhalb des zulässigen Bereichs liegt, wird ein ValueError ausgelöst.

### Changelog

Version | Beschreibung
--- | ---
8.0.0 | Wenn `count` außerhalb des zulässigen Bereichs liegt, löst array_fill() nun einen ValueError aus; zuvor wurde ein Fehler der Stufe `E_WARNING` erzeugt, und die Funktion gab `false` zurück.

### Beispiele

Beispiel #1 array_fill()-Beispiel

`<?php
$a = array_fill(5, 6, 'Banane');
print_r($a);
?>`

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

    Array
    (
        [5]  => Banane
        [6]  => Banane
        [7]  => Banane
        [8]  => Banane
        [9]  => Banane
        [10] => Banane
    )

Beispiel #2 array_fill()-Beispiel mit einem negativen Startindex

`<?php
$a = array_fill(-2, 4, 'Birne');
print_r($a);
?>`

Das oben gezeigte Beispiel erzeugt mit PHP 8 folgende Ausgabe:

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

Das oben gezeigte Beispiel erzeugt mit PHP 7 folgende Ausgabe:

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

Es ist zu beachten, dass es den Index `-1` vor PHP 8.0.0 nicht gibt.

### Anmerkungen

Für eine detaillierte Erklärung von negativen Schlüsseln siehe auch den Abschnitt Arrays des Handbuchs.

### Siehe auch

- array_fill_keys() - Befüllt ein Array mit Werten mit den übergebenen Schlüsseln
- str_repeat() - Wiederholt einen String
- range() - Erstellt ein Array mit einem Bereich von Elementen

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open