array_push
(PHP 4, PHP 5, PHP 7, PHP 8)
array_push — Fügt ein oder mehr Elemente an das Ende eines Arrays an
Beschreibung
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.
Parameter-Liste
-
array -
Das Eingabe-Array.
-
values -
Die Werte, die am Ende von
arrayangefügt werden sollen.
Rückgabewerte
Liefert die neue Anzahl Elemente des Arrays.
Changelog
| Version | Beschreibung |
|---|---|
| 7.3.0 | Diese Funktion kann nun mit nur einem Parameter aufgerufen werden. Zuvor waren mindestens zwei Parameter erforderlich. |
Beispiele
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
)
Siehe auch
- array_pop() - Liefert und entfernt das letzte Element eines Arrays
- array_shift() - Liefert und entfernt das erste Element eines Arrays
- array_unshift() - Fügt ein oder mehr Elemente am Anfang eines Arrays ein
