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).

Syntax

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

Parameter Description
array Required. Specifying an array
value1 Required. Specifies a value to insert
value2 Optional. Specifies a value to insert
value3 Optional. Specifies a value to insert


Tips and Notes

Hint: 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).

Example

<?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

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

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
Have Any Suggestion? We Are Waiting To Hear from YOU!

Your Query was successfully sent!