array_shift
(PHP 4, PHP 5)
array_shift — 将数组开头的单元移出数组
说明
mixed <strong>array_shift</strong>
( array <code>&$array</code>
)
<p>
<strong>array_shift()</strong> 将
<code>array</code> 的第一个单元移出并作为结果返回,将
<code>array</code> 的长度减一并将所有其它单元向前移动一位。所有的数字键名将改为从零开始计数,文字键名将不变。
</p>
<p><strong>Note</strong>: 使用此函数后会重置(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() - 将数组最后一个单元弹出(出栈)