X
HOME HTML5 CSS3 JAVASCRIPT SQL PHP5 JQUERY ANGULAR BOOTSTRAP3 XML MORE...
REFERENCES | EXAMPLES | FORUM | ABOUT

PHP array_unshift() Function

PHP Array Reference PHP Array Reference

Example

Insert the element "blue" to an array:

<?php
$a=array("a"=>"red","b"=>"green");
array_unshift($a,"blue");
print_r($a);
?>

Run example »

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.

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

Note: Numeric keys will start at 0 and increase by 1. String keys will remain the same.


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

Technical Details

Return Value: Returns the new number of elements in the 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"));
?>

Run example »

Example 2

Using numeric keys:

<?php
$a=array(0=>"red",1=>"green");
array_unshift($a,"blue");
print_r($a);
?>

Run example »


PHP Array Reference PHP Array Reference

Your suggestion:

Close [X]

Thank You For Helping Us!

Your message has been sent to W3Schools.

Close [X]
Search w3schools.com:

WEB HOSTING

UK Reseller Hosting

WEB BUILDING

Download XML Editor FREE Website BUILDER Free HTML5 Templates

SHARE THIS PAGE

facebook