array_shift

(PHP 4, PHP 5)

array_shift — Extrae un elemento del comienzo de la matriz

Descripción

mixed array_shift ( array &$array )

array_shift() extrae el primer valor de la matriz y lo devuele, acortando la matriz en un elemento y moviendo todo hacia abajo. Todos los índices numéricos de la matriz serán modificados para empezar desde cero, mientras que los índices literales no serán tocados. Si array está vacío (o no es una matriz), se regresará NULL

Note: Esta función ejecutará un reset() en el puntero array después de su uso.

Example#1 Ejemplo de array_shift()


<?php
$pila = array ("naranja", "plátano", "manzana", "frambueza");
$fruta = array_shift ($pila);
print_r($pila);
?>

Esto resulta en $pila conteniendo 3 elementos:

Array
(
    [0] => plátano
    [1] => manzana
    [2] => frambueza
)

y naranja es asignada a $fruta.

Vea también: array_unshift(), array_push(), y array_pop().