array_pad

(PHP 4, PHP 5, PHP 7)

array_padFüllt ein Array bis auf die angegebene Länge mit einem Wert auf

Beschreibung

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

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(12109);

$ergebnis array_pad($eingabe50);
// 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($eingabe2"noop");
// nicht erweitert
?>

Siehe auch

  • array_fill() - Füllt ein Array mit Werten
  • range() - Erstellt ein Array mit einem Bereich von Elementen