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