(PHP 4, PHP 5, PHP 7)
array_pad — Füllt ein Array bis auf die angegebene Länge mit einem Wert auf
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.
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.
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.
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
?>