(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.