array_unshift

(PHP 4, PHP 5)

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

Beschreibung

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

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.
value1: Der erste einzufügende Wert.

Rückgabewerte

Gibt die neue Anzahl der in array enthaltenen Elemente zurück.

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 ein Element vom Beginn 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