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

array_shift
Prev	III. Array-Related Functions	Next

array_shift

Name

array_shift — Returns the first element of the array and removes the element from the array.

Synopsis

mixed array_shift(array); array array: Array to be shortened

Returns

First element of an array; NULL on failure or if the array is empty

Description

This function pulls the first element off the array and returns it, while shortening the array by the first element and moving all other elements down by one.

Used with array_push() , this function can make an array act in FIFO (first-in-first-out) fashion.

Warning

This function directly alters the array passed to it.

Version

PHP 4

Example

Example 31. Pop an element from the beginning of an array

$arr1 = array("one", "two", "three", "four");
echo "First element was: ", array_shift($arr1), "\n";
echo "Current array: ", implode(", ", $arr1);

Output:
First element was: one
Current array: two, three, four

Prev	Home	Next
array_reverse	Up	array_slice

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.