array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'it', ), 'this' => array ( 0 => 'function.array-shift.php', 1 => 'array_shift', 2 => 'Estrae l\'elemento alla testa dell\'array', ), 'up' => array ( 0 => 'ref.array.php', 1 => 'Array Funzioni', ), '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' => 'it', 'path' => 'reference/array/functions/array-shift.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

array_shift

(PHP 4, PHP 5, PHP 7, PHP 8)

array_shift — Estrae l'elemento alla testa dell'array

Descrizione

array_shift(array $array): mixed

array_shift() estrae il primo elemento di array e lo restituisce, accorciando array di un elemento e spostando tutti gli altri all'indietro. Tutte le chiavi numeriche verranno modificate al fine di iniziare il conteggio da zero, mentre gli indici alfabetici non verranno modificati. Se array è vuoto (o non è un array), viene restituito null.

Nota: Questa funzione farà il reset() del puntatore dell'array dopo l'uso.

Example #1 esempio di array_shift()

<?php
$pila = array("arancia", "banana", "mela", lampone");
$frutto = array_shift($pila);
print_r($pila);
?>

In questo modo $pila rimarrà con 3 elementi: 

Array
(
    [0] => banana
    [1] => mela
    [2] => lampone
)

e arancia sarà assegnata a $frutto.

Vedere anche array_unshift(), array_push() e array_pop().