Fügt ein oder mehr Elemente am Anfang eines Arrays ein

Beschreibung

array_unshift ( array &$array [, mixed $... ] ) : int

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 die selbe Reihenfolge haben. Die numerischen Schlüssel werden so modifiziert, dass bei 0 zu zählen begonnen wird, Strings als Schlüssel bleiben unverändert.

Parameter-Liste

array: Das Eingabe-Array.
...: 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