Du bist hier: Tips » Scripte » PHP
PHP
Referenzliste

array_shift

Array-Funktionen

    Befehl:
mixed array_shift ( array &$array )


    Parameter-Liste:
NameBeschreibung
arrayDas zu verarbeitende Array.

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

    Beschreibung:
Die Funktion array_shift() entfernt das erste Element aus einem Array (array) und gibt dieses Element zurück. Dabei wird das Array um ein Element verkürzt, wobei die Schlüssel bei 0 beginnend neu aufgebaut werden.

Sollte es sich bei den Schlüsseln um Strings als Schlüssel handeln, so bleiben diese unberührt.

Falls array leer oder kein Array sein sollte, so werden Sie als Rückgabewert NULL erhalten.


    Aktiv in Version:
(PHP 4, PHP 5, PHP 7)

    Siehe auch:
Fügt ein oder mehr Elemente am Anfang eines Arrays ein
 
Fügt ein oder mehr Elemente an das Ende eines Arrays
 
Liefert das letzte Element eines Arrays
 

array_shift() - Beispiel:


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


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

Beschreibung:
Orange wird der Variable $fruit zugewiesen.
Array-Funktionen