What is PhpDig?
PhpDig is a PHP MySQL based
Web Spider & Search Engine.

array_unshift
Prev	III. Array-Related Functions	Next

array_unshift

Name

array_unshift — Pushes the list of elements onto the given array.

Synopsis

int array_unshift(array, var[, . . .]); array array: Array to modify mixed var: Value to prepend to array mixed . . . (optional): Further values to prepend to array

Returns

Number of elements in the revised array; NULL on failure

Description

Prepends the new elements onto array in the order given as arguments. The first element in the argument list becomes the first element in the array. Returns the number of elements in the revised array. This function changes the original array.

Combined with array_pop() , this function can be used to make an array act in FIFO (first-in-first-out) fashion.

Version

PHP 4

Example

Example 36. Push values onto the beginning of an array

$arr1 = array("one", "two", "three");
$rv = array_unshift($arr1, "four", "five");
echo "New array: ", implode(", ", $arr1);

Output:
New array: four, five, one, two, three

Prev	Home	Next
array_unique	Up	array_values

PHP Functions Essential Reference. Copyright © 2002 by New Riders Publishing (Authors: Zak Greant, Graeme Merrall, Torben Wilson, Brett Michlitsch). This material may be distributed only subject to the terms and conditions set forth in the Open Publication License, v1.0 or later (the latest version is presently available at http://www.opencontent.org/openpub/). The authors of this book have elected not to choose any options under the OPL. This online book was obtained from http://www.fooassociates.com/phpfer/ and is designed to provide information about the PHP programming language, focusing on PHP version 4.0.4 for the most part. The information is provided on an as-is basis, and no warranty or fitness is implied. All persons and entities shall have neither liability nor responsibility to any person or entity with respect to any loss or damage arising from the information contained in this book.