array_shift
(PHP 4, PHP 5, PHP 7, PHP 8)
array_shift — 將陣列開頭的單元移出陣列
說明
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。