array_shift

(PHP 4, PHP 5)

array_shift -- 配列の先頭から要素を一つ取り出す

説明

mixed array_shift ( array &array )

array_shift() は、array の最初の値を取り出して返します。配列 array は、要素一つ分だけ短くなり、全ての要素は前にずれます。 array が空の場合 (または配列でない場合)、 NULL が返されます。

注意: この関数は、 配列 (array) ポインタを使用した後にリセット (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() も参照ください。