array_shift

(PHP 4, PHP 5, PHP 7, PHP 8)

array_shift — 將數(shù)組開(kāi)頭的單元移出數(shù)組

array_shift(array &$array): mixed

array_shift() 將 array 的第一個(gè)單元移出并作為結(jié)果返回，將 array 的長(zhǎng)度減一并將所有其它單元向前移動(dòng)一位。所有的數(shù)字鍵名將改為從零開(kāi)始計(jì)數(shù)，文字鍵名將不變。

注意: 使用此函數(shù)后會(huì)重置（reset()）array 指針。

返回移出的值，如果 array 為空或不是一個(gè)數(shù)組則返回 null。

示例 #1 array_shift() 例子


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

以上例程會(huì)輸出：

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

并且 orange 被賦給了 $fruit。