PHP array_unshift()Functions
Examples
Insert element "blue" into the array:
<?php
$a=array("a"=>"red","b"=>"green");
array_unshift($a,"blue");
print_r($a);
?>
$a=array("a"=>"red","b"=>"green");
array_unshift($a,"blue");
print_r($a);
?>
Run Example »
Definition and Usage
The array_unshift() function is used to insert new elements into an array. The new values will be inserted at the beginning of the array.
Tip:You can insert one or more values.
Note:Numeric keys will start from 0 and increase by 1. String keys will remain unchanged.
Syntax
array_unshift(array,value1,value2,value3...)
| Parameter | Description |
|---|---|
| array | Required. Specifies the array. |
| value1 | Required. Specifies the value to insert. |
| value2 | Optional. Specifies the value to insert. |
| value3 | Optional. Specifies the value to insert. |
Technical Details
| Return Value: | Returns the number of elements in the new array. |
|---|---|
| PHP Version: | 4+ |
More Examples
Example 1
Show the return value:
<?php
$a=array("a"=>"red","b"=>"green");
print_r(array_unshift($a,"blue"));
?>
$a=array("a"=>"red","b"=>"green");
print_r(array_unshift($a,"blue"));
?>
Run Example »
Example 2
Using numeric keys:
<?php
$a=array(0=>"red",1=>"green");
array_unshift($a,"blue");
print_r($a);
?>
$a=array(0=>"red",1=>"green");
array_unshift($a,"blue");
print_r($a);
?>
Run Example »
Complete PHP Array Reference Other Extensions