(PHP 4, PHP 5, PHP 7, PHP 8)
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 length angegebene Größe mit dem Wert value aufgefüllt wurde. Ist der Parameter length positiv, wird das Array rechts erweitert, ist er negativ, dann erfolgt die Erweiterung links. Ist der Betrag von length kleiner oder gleich der Länge von array, erfolgt keine Erweiterung.
arrayDas Array, das aufgefüllt werden soll.
lengthDie neue Größe des Arrays.
value Der Wert, mit dem das Array array aufgefüllt wird, falls es kleiner als length ist.
Gibt eine Kopie von array zurück, welche auf die mit length angegebene Größe mit dem Wert value aufgefüllt wurde. Ist der Parameter length positiv, wird das Array rechts erweitert, ist er negativ, dann erfolgt die Erweiterung links. Ist der Betrag von length kleiner oder gleich der Länge von array, erfolgt keine Erweiterung.
| Version | Beschreibung |
|---|---|
| 8.3.0 | Vor 8.3 konnten nur 1048576 Elemente auf einmal hinzugefügt werden, nun ist dies nur noch durch die maximale Größe eines Arrays begrenzt. |
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
?>