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().