array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.array-shift.php', 1 => 'array_shift', ), 'up' => array ( 0 => 'ref.array.php', 1 => 'Funções para Array', ), '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' => 'pt_BR', '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 — 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 serão alteradas para começar a contar a partir de zero,
enquanto chaves literais não serão afetadas.
Nota: Após o uso desta função, assim como na função reset(), o ponteiro interno do array fornecido apontará para o primeiro elemento.
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
$stack = array("orange", "banana", "apple", "raspberry");
$fruit = array_shift($stack);
print_r($stack);
?>
O exemplo acima produzirá:
Array ( [0] => banana [1] => apple [2] => raspberry )
e orange
seria passado para
$fruit.