array_shift

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

array_shift 將數組開頭的單元移出數組

說明

array_shift(array &$array): mixed

array_shift()array 的第一個單元移出并作為結果返回,將 array 的長度減一并將所有其它單元向前移動一位。所有的數字鍵名將改為從零開始計數,文字鍵名將不變。

注意: 使用此函數后會重置(reset()array 指針。

參數

array

輸入的數組。

返回值

返回移出的值,如果 array 為 空或不是一個數組則返回 null

范例

示例 #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() - 彈出數組最后一個單元(出棧)