array_pad
(PHP 4, PHP 5, PHP 7, PHP 8)
array_pad — Füllt ein Array bis auf die angegebene Länge mit einem Wert auf
Beschreibung
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. Es können pro
Aufruf maximal 1048576 Elemente hinzugefügt werden.
Parameter-Liste
-
array -
Das Array, das aufgefüllt werden soll.
-
length -
Die neue Größe des Arrays.
-
value -
Der Wert, mit dem das Array
arrayaufgefüllt wird, falls es kleiner alslengthist.
Rückgabewerte
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.
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() - Füllt ein Array mit Werten
- range() - Erstellt ein Array mit einem Bereich von Elementen
