(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)
array_fill — Füllt ein Array mit Werten
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.
start_indexDer 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.
valueEinzufügender Wert
Gibt das gefüllte Array zurück
Wenn count außerhalb des zulässigen Bereichs liegt, wird ein ValueError ausgelöst.
| 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. |
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 7 folgende Ausgabe:
Array ( [-2] => Birne [0] => Birne [1] => Birne [2] => Birne )
Das oben gezeigte Beispiel erzeugt mit PHP 8 folgende Ausgabe:
Array ( [-2] => Birne [-1] => Birne [0] => Birne [1] => Birne )
Es ist zu beachten, dass es den Index -1 vor PHP 8.0.0 nicht gibt.
Für eine detaillierte Erklärung von negativen Schlüsseln siehe auch den Abschnitt Arrays des Handbuchs.