array_shift

(PHP 4, PHP 5, PHP 7)

array_shift — Quita un elemento del principio del array

Descripción

array_shift ( array &$array ) : mixed

array_shift() Quita el primer valor del array y lo devuelve, acortando el array un elemento y corriendo el array hacia abajo. Todas la claves del array numéricas serán modificadas para que empiece contando desde cero mientras que los arrays con claves literales no serán modificados.

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

Parámetros

array: El array de entrada.

Valores devueltos

Devuelve el valor quitado, o NULL si el array está vacío o no es un array.

Ejemplos

Ejemplo #1 Ejemplo de array_shift()


<?php
$stack = array("naranja", "plátano", "manzana", "frambuesa");
$fruit = array_shift($stack);
print_r($stack);
?>

El resultado del ejemplo sería:

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

y naranja será asigando a $fruit.

Ver también

array_unshift() - Añadir al inicio de un array uno a más elementos
array_push() - Inserta uno o más elementos al final de un array
array_pop() - Extrae el último elemento del final del array