array_unshift
(PHP 4, PHP 5, PHP 7, PHP 8)
array_unshift — Fügt ein oder mehr Elemente am Anfang eines Arrays ein
Beschreibung
array_unshift() fügt die übergebenen Elemente am Anfang
von array ein. Beachten Sie, dass die Liste von
Elementen als Ganzes eingefügt wird, sodass die eingefügten Elemente ihre
Reihenfolge behalten. Die numerischen Schlüssel werden so modifiziert, dass
sie bei Null beginnen, während String-Schlüssel unverändert bleiben.
Hinweis:
Setzt den internen Zeiger des Arrays auf das erste Element zurück.
Parameter-Liste
-
array -
Das Eingabe-Array.
-
values -
Die einzufügenden Werte.
Rückgabewerte
Gibt die neue Anzahl der in array enthaltenen Elemente
zurück.
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_unshift()-Beispiel
<?php
$queue = array("Orange", "Banane");
array_unshift($queue, "Apfel", "Himbeere");
?>
Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
Array
(
[0] => Apfel
[1] => Himbeere
[2] => Orange
[3] => Banane
)
Siehe auch
- array_shift() - Liefert und entfernt das erste Element eines Arrays
- array_push() - Fügt ein oder mehr Elemente an das Ende eines Arrays an
- array_pop() - Liefert und entfernt das letzte Element eines Arrays
