array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'de', ), 'this' => array ( 0 => 'function.array-shift.php', 1 => 'array_shift', ), 'up' => array ( 0 => 'ref.array.php', 1 => 'Array Funktionen', ), 'prev' => array ( 0 => 'function.array-search.php', 1 => 'array_search', ), 'next' => array ( 0 => 'function.array-slice.php', 1 => 'array_slice', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'de', 'path' => 'reference/array/functions/array-shift.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 4, PHP 5, PHP 7, PHP 8)
array_shift — Liefert und entfernt das erste Element eines Arrays
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.
array
Das zu verarbeitende Array
Gibt den ersten Wert zurück oder null
, wenn
array
leer oder kein Array ist.
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.