array_fill
(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)
array_fill — Füllt ein Array mit Werten
Beschreibung
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. Nur nicht-negative Indizes werden unterstützt.
Wenn
start_indexnegativ ist, ist der erste Index des zurückgebenen Arraysstart_index; alle weiteren Indexe starten bei 0 (siehe Beispiel). -
count -
Anzahl der einzufügenden Elemente. Muss größer oder gleich 0 und kleiner oder gleich
2147483647sein. -
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');
$b = array_fill(-2, 4, 'Birne');
print_r($a);
print_r($b);
?>
Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
Array
(
[5] => Banane
[6] => Banane
[7] => Banane
[8] => Banane
[9] => Banane
[10] => Banane
)
Array
(
[-2] => Birne
[0] => Birne
[1] => Birne
[2] => Birne
)
Anmerkungen
Für eine detaillierte Erklärung von negativen Schlüsseln siehe auch den Abschnitt Array 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
