array_fill
(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)
array_fill — Füllt ein Array mit Werten
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.
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 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.
Anmerkungen
Für eine detaillierte Erklärung von negativen Schlüsseln siehe auch den
Abschnitt Arrays des Handbuchs.