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. Nur nicht-negative Indizes werden unterstützt.

Wenn start_index negativ ist, ist der erste Index des zurückgebenen Arrays start_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 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');
$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
)