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
)

そして$fruitorangeが 割り当てられます。

array_unshift(), array_push(), array_pop()も参照してください。