array_shift

    (PHP 4, PHP 5, PHP 7, PHP 8)

    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 las claves literales no se verán afectadas.

    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
    To Top