PHP-Handbuch: Füllt ein Array bis auf die angegebene Länge mit einem Wert auf

Beschreibung

array array_pad ( array $array , int $size , mixed $value )

array_pad gibt eine Kopie von array zurück, welche auf die mit size angegebene Größe mit dem Wert value aufgefüllt wurde. Ist der Parameter size positiv, wird das Array rechts erweitert, ist er negativ, dann erfolgt die Erweiterung links. Ist der Betrag von size kleiner oder gleich der Länge von array, erfolgt keine Erweiterung. Es können pro Aufruf maximal 1048576 Elemente hinzugefügt werden.

Parameter-Liste

array: Das Array, das aufgefüllt werden soll.
size: Die neue Größe des Arrays.
value: Der Wert, mit dem das Array array aufgefüllt wird, falls es kleiner als size ist.

Rückgabewerte

Gibt eine Kopie von array zurück, welche auf die mit size angegebene Größe mit dem Wert value aufgefüllt wurde. Ist der Parameter size positiv, wird das Array rechts erweitert, ist er negativ, dann erfolgt die Erweiterung links. Ist der Betrag von size kleiner oder gleich der Länge von array, erfolgt keine Erweiterung.

Beispiele

Beispiel #1 array_pad-Beispiel


<?php
$eingabe = array(12, 10, 9);

$ergebnis = array_pad($eingabe, 5, 0);
// Ergebnis ist array(12, 10, 9, 0, 0)

$ergebnis = array_pad($eingabe, -7, -1);
// Ergebnis ist array(-1, -1, -1, -1, 12, 10, 9)

$ergebnis = array_pad($eingabe, 2, "noop");
// nicht erweitert
?>

Siehe auch

array_fill
range