array_shift

(PHP 4, PHP 5)

array_shift --  將陣列開頭的單元移出陣列

說明

mixed array_shift ( array &array )

array_shift()array 的第一個單元移出並作為結果返回,將 array 的長度減一併將所有其它單元向前搬移一位。所有的數字鍵名將改為從零開始計數,文字鍵名將不變。若果 array 為空(或是不是陣列),則返回 NULL

注: 使用本函數後會重設(reset())陣列指標。

例子 1. array_shift() 例子

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

這將使 $stack 剩下 3 個單元:

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

並且 orange 被賦給了 $fruit

參見 array_unshift()array_push()array_pop()