(PHP 4, PHP 5, PHP 7, PHP 8)
array_push — Fügt ein oder mehr Elemente an das Ende eines Arrays an
array_push() behandelt array
als Stapel (Stack), und fügt die übergebenen Variablen an das Ende von array
an. Die Länge von array
wird dabei um die Anzahl der angefügten Variablen erhöht. Dies hat den selben Effekt wie:
<?php
$array[] = $var;
?>
Hinweis: Wenn Sie array_push() verwenden, um ein Element an ein Array anzuhängen, ist es besser
$array[] =
zu benutzen, da dies den zusätzlichen Aufwand vermeidet, eine Funktion aufzurufen
Hinweis: array_push() gibt eine Warnung aus, wenn das erste Argument kein Array ist. Dies unterschied sich vom Verhalten von
$var[]
vor PHP 7.1.0, bei dem ein neues Array erstellt wurde.
array
Das Eingabe-Array.
values
Die Werte, die am Ende von array
angefügt werden sollen.
Liefert die neue Anzahl Elemente des Arrays.
Version | Beschreibung |
---|---|
7.3.0 | Diese Funktion kann nun mit nur einem Parameter aufgerufen werden. Zuvor waren mindestens zwei Parameter erforderlich. |
Beispiel #1 array_push() Beispiel
<?php
$stack = array("Orange", "Banane");
array_push($stack, "Apfel", "Himbeere");
print_r($stack);
?>
Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
Array ( [0] => Orange [1] => Banane [2] => Apfel [3] => Himbeere )