Php/docs/function.array-shift

来自菜鸟教程
跳转至:导航、​搜索

array_shift

(PHP 4, PHP 5, PHP 7)

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


说明

array_shift ( array &$array ) : mixed

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() - 弹出数组最后一个单元(出栈)