PHP数组函数array_shift()的用法

array_shift

(PHP 4, PHP 5)

array_shift —
将数组开头的单元移出数组

说明

mixed array_shift ( array &$array )

array_shift() 将 array 的第一个单元移出并作为结果返回，将 array 的长度减一并将所有其它单元向前移动一位。所有的数字键名将改为从零开始计数，文字键名将不变。

Note: 使用此函数后会重置（reset()）array
指针。

参数

array

输入的数组。

返回值

返回移出的值，如果 array 为 空或不是一个数组则返回 NULL。

范例

Example #1 array_shift() 例子

<?php
$stack = array("orange", "banana", "apple", "raspberry");
$fruit = array_shift($stack);
print_r($stack);
?>

以上例程会输出：

Array
(
    [0] => banana
    [1] => apple
    [2] => raspberry
)

并且 orange 被赋给了 $fruit。

参见

array_unshift() – 在数组开头插入一个或多个单元
array_push() – 将一个或多个单元压入数组的末尾（入栈）
array_pop() – 将数组最后一个单元弹出（出栈）