PHP array_unshift() Function

Complete PHP Array Reference

Definition and Usage

The array_unshift() function inserts new elements to an array. The new array values will be inserted in the beginning of the array. The function's return value is the new number of elements in the array (See example 2).

Syntax

array_unshift(array,value1,value2,value3...)

Tips and Notes

Tip: You can add one value, or as many as you like.

Note: Numeric keys will start at 0 and increas by 1 (See example3). String keys will remain the same (See example 1).

Example 1

<?php
$a=array("a"=>"Cat","b"=>"Dog");
array_unshift($a,"Horse");
print_r($a);
?>

The output of the code above will be:

Array ( [0] => Horse [a] => Cat [b] => Dog )

Example 2

Return value:

<?php
$a=array("a"=>"Cat","b"=>"Dog");
print_r(array_unshift($a,"Horse"));
?>

The output of the code above will be:

3

Example 3

Numeric keys:

<?php
$a=array(0=>"Cat",1=>"Dog");
array_unshift($a,"Horse");
print_r($a);
?>

The output of the code above will be:

Array ( [0] => Horse [1] => Cat [2] => Dog )

Complete PHP Array Reference

Learn XML with Stylus Studio XML Tools - Free Download!

Stylus Studio makes it easy to edit and validate XML, XSLT, DTD, XML Schema, XHTML, XPath, XQuery and Web Service applications. Free XML video demonstrations will help you learn XML and become a W3C XML development master in just minutes! Download a FREE Trial Now!

Jump to: Top of Page or HOME or Printer friendly page

W3Schools provides material for training only. We do not warrant the correctness of its contents. The risk from using it lies entirely with the user. While using this site, you agree to have read and accepted our terms of use and privacy policy.

Copyright 1999-2007 by Refsnes Data. All Rights Reserved.

W3Schools was converted to XHTML in December 1999