PHP Manual
Prev |  | Next

# array_unshift

array_unshift -- Push one or more elements onto the beginning of array

## Description

``int array_unshift`(array array, mixed var, [...] );`

array_unshift() prepends passed elements to the front of the `array`. Note that the list of elements is prepended as a whole, so that the prepended elements stay in the same order.

Returns the new number of elements in the `array`.

Example 1. array_unshift() example

      1
      2 $queue = array("p1", "p3");
      3 array_unshift($queue, "p4", "p5", "p6");
      4

This would result in $queue having 5 elements: "p4", "p5", "p6", "p1", and "p3".

See also array_shift(), array_push(), and array_pop().

> Note: This function was added in PHP 4.0.

Prev | Home | Next
array_splice | Up | array_values