(PHP 4, PHP 5)
array_shift — Retira o primeiro elemento de um array
array_shift() retira o primeiro elemento de
array
e o retorna, diminuindo
array
em um elemento e movendo todos os outros
elementos para trás. Todas as chaves numéricas alteradas para começar a
contar a de 0 (zero), enquanto chaves string permanecerão inalteradas.
Nota: Esta função irá resetar() o ponteiro do array depois do uso.
array
O array de entrada.
Retorna o valor removido, ou NULL
se array
for
vazio ou não é um array.
Exemplo #1 Exemplo da array_shift()
<?php
$cesta = array("laranja", "banana", "melancia", "morango");
$fruta = array_shift($cesta);
print_r($cesta);
?>
O exemplo acima irá imprimir:
Array ( [0] => banana [1] => melancia [2] => morango )
e laranja seria passado para $fruta.