array_shift
(PHP 4, PHP 5, PHP 7, PHP 8)
array_shift — Liefert und entfernt das erste Element eines Arrays
Beschreibung
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() - Fügt ein oder mehr Elemente am Anfang eines Arrays ein
- array_push() - Fügt ein oder mehr Elemente an das Ende eines Arrays an
- array_pop() - Liefert und entfernt das letzte Element eines Arrays

