array_unshift(3) php man page | unix.com

ARRAY_UNSHIFT(3)							 1							  ARRAY_UNSHIFT(3)

array_unshift - Prepend one or more elements to the beginning of an array

SYNOPSIS
       int array_unshift (array  &$array, mixed  $value1, [mixed  $...])

DESCRIPTION
       array_unshift(3)  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. All numerical array keys will be modified to start counting from zero while literal  keys  won't
       be touched.

PARAMETERS
	      o $array
		- The input array.

	      o $value1
		- First value to prepend.

RETURN VALUES
	Returns the new number of elements in the $array.

EXAMPLES
       Example #1

	      array_unshift(3) example

	      <?php
	      $queue = array("orange", "banana");
	      array_unshift($queue, "apple", "raspberry");
	      print_r($queue);
	      ?>

	      The above example will output:

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

SEE ALSO
       array_shift(3), array_push(3), array_pop(3).

PHP Documentation Group 													  ARRAY_UNSHIFT(3)