array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'de', ), 'this' => array ( 0 => 'function.array-pad.php', 1 => 'array_pad', 2 => 'Füllt ein Array bis auf die angegebene Länge mit einem Wert auf', ), 'up' => array ( 0 => 'ref.array.php', 1 => 'Array Funktionen', ), 'prev' => array ( 0 => 'function.array-multisort.php', 1 => 'array_multisort', ), 'next' => array ( 0 => 'function.array-pop.php', 1 => 'array_pop', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'de', 'path' => 'reference/array/functions/array-pad.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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(array $array, int $length, mixed $value): array

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.

Parameter-Liste

array

Das Array, das aufgefüllt werden soll.

length

Die neue Größe des Arrays.

value

Der Wert, mit dem das Array array aufgefüllt wird, falls es kleiner als length ist.

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.

Changelog

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.

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)
echo join(', ', $ergebnis), PHP_EOL;

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

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

Siehe auch