PHP-Handbuch: Liefert und entfernt das erste Element 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.

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

Parameter-Liste

array: Das zu verarbeitende Array

Rückgabewerte

Gibt den ersten Wert zurück oder NULL, wenn array leer oder kein Array ist.

Beispiele

Beispiel #1 array_shift-Beispiel


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

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

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

und Orange wird der Variable $fruit zugewiesen.

Siehe auch

array_unshift
array_push
array_pop