PHP Basic
PHP HOME PHP Intro PHP Install PHP Syntax PHP Variables PHP String PHP Operators PHP If...Else PHP Switch PHP Arrays PHP Sorting Arrays PHP While Loops PHP For Loops PHP Functions PHP Forms PHP $_GET PHP $_POSTPHP Advanced
PHP Arrays Multi PHP Date PHP Include PHP File PHP File Upload PHP Cookies PHP Sessions PHP E-mail PHP Secure E-mail PHP Error PHP Exception PHP FilterPHP Database
PHP MySQL Intro PHP MySQL Connect PHP CREATE DB/Table PHP INSERT INTO PHP SELECT PHP WHERE PHP ORDER BY PHP UPDATE PHP DELETE PHP ODBCPHP XML
XML Expat Parser XML DOM XML SimpleXMLPHP and AJAX
AJAX Intro AJAX PHP AJAX Database AJAX XML AJAX Live Search AJAX RSS Reader AJAX PollPHP Reference
PHP Array PHP Calendar PHP Date PHP Directory PHP Error PHP Filesystem PHP Filter PHP FTP PHP HTTP PHP Libxml PHP Mail PHP Math PHP Misc PHP MySQLi PHP SimpleXML PHP String PHP XML PHP Zip PHP TimezonesPHP Quiz
PHP Quiz PHP CertificatePHP 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...)
| 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
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);
?>
$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"));
?>
$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);
?>
$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
W3Schools' Online Certification
The perfect solution for professionals who need to balance work, family, and career building.
More than 10 000 certificates already issued!
The HTML Certificate documents your knowledge of HTML.
The HTML5 Certificate documents your knowledge of advanced HTML5.
The CSS Certificate documents your knowledge of advanced CSS.
The JavaScript Certificate documents your knowledge of JavaScript and HTML DOM.
The jQuery Certificate documents your knowledge of jQuery.
The XML Certificate documents your knowledge of XML, XML DOM and XSLT.
The ASP Certificate documents your knowledge of ASP, SQL, and ADO.
The PHP Certificate documents your knowledge of PHP and SQL (MySQL).
Your suggestion:
Close [X]
Thank You For Helping Us!
Your message has been sent to W3Schools.
Close [X]
