array_shift

Shift an element off the beginning of array

&reftitle.description; `mixed` `array_shift` `array` `array`

`array_shift` shifts the first value of the `array` off and returns it, shortening the `array` by one element and moving everything down. All numerical array keys will be modified to start counting from zero while literal keys won't be affected.

&array.resetspointer;
&reftitle.parameters;

`array`

- The input array.

&reftitle.returnvalues;

Returns the shifted value, or &null; if `array` is empty or is not an array.

&reftitle.examples;

### `array_shift` example

    <?php
    $stack = array("orange", "banana", "apple", "raspberry");
    $fruit = array_shift($stack);
    print_r($stack);
    ?>

&example.outputs;

    Array
    (
        [0] => banana
        [1] => apple
        [2] => raspberry
    )

and `orange` will be assigned to `$fruit`.

&reftitle.seealso;

- `array_unshift`
- `array_push`
- `array_pop`