array_shift

(PHP 4, PHP 5)

array_shift — Liefert ein Element vom Beginn eines Arrays

Beschreibung

mixed array_shift ( array &$array )

array_shift() liefert den ersten Wert von array , verschiebt die anderen Werte hinunter, und verkürzt array um ein Element. Alle numerischen Schlüssel werden so modifiziert, dass bei null zu zählen begonnen wird. Strings als Schlüssel bleiben unverändert. Ist array leer (oder kein Array), wird NULL zurückgegeben.

Hinweis: Diese Funktion setzt (reset()) nach Verwendung den array-Zeiger zurück.

Beispiel #1 array_shift()


<?php
$stack = array("Orange", "Banane", "Apfel", "Himbeere");
$fruit = array_shift($stack);
print_r($stack);
?>

Danach blieben in $stack 3 Elemente übrig:

Array
(
    [0] => Banane
    [1] => Apfel
    [2] => Himbeere
)

und orange wird $fruit zugeordnet.

Siehe auch array_unshift(), array_push() und array_pop().