array_unshift
array_unshift
(PHP 4, PHP 5, PHP 7)
array_unshift — Prepend one or more elements to the beginning of an array
Description
int array_unshift ( array &$array , mixed $value1 [, mixed $... ] )
array_unshift() prepends passed elements to the front of the array. Note that the list of elements is prepended as a whole, so that the prepended elements stay in the same order. All numerical array keys will be modified to start counting from zero while literal keys won't be changed.
Parameters
-
array -
The input array.
-
value1 -
First value to prepend.
Return Values
Returns the new number of elements in the array.
Examples
Example #1 array_unshift() example
<?php
$queue = array("orange", "banana");
array_unshift($queue, "apple", "raspberry");
print_r($queue);
?> The above example will output:
Array
(
[0] => apple
[1] => raspberry
[2] => orange
[3] => banana
)
See Also
- array_shift() - Shift an element off the beginning of array
- array_push() - Push one or more elements onto the end of array
- array_pop() - Pop the element off the end of array
© 1997–2017 The PHP Documentation Group
Licensed under the Creative Commons Attribution License v3.0 or later.
https://secure.php.net/manual/en/function.array-unshift.php
