PHP array_shift()関数

PHP Array ReferencePHP Array リファレンスマニュアル全体

例

配列の最初の要素(red)を削除し、削除した要素を返します:

<?php $a=array("a"=>"red","b"=>"green","c"=>"blue"); echo array_shift($a); print_r ($a); ?>

サンプルを実行 »

定義と使い方

array_shift() 関数は配列の最初の要素を削除し、削除した要素を返します。

注:キー名が数値の場合、すべての要素に新しいキー名が付けられます。キー名は 0 から始まり、1 ずつ増加します(下記の例を参照)。


構文

array_shift(array)

パラメータ 説明
array 必須です。配列を指定します。

技術詳細

戻り値: 配列から削除した要素の値を返します。配列が空の場合は NULL を返します。
PHP バージョン: 4+


その他の例

例1

数値のキー名を使用すると、すべての要素に新しいキー名が付けられます:

<?php $a=array(0=>"red",1=>"green",2=>"blue"); echo array_shift($a); print_r ($a); ?>

サンプルを実行 »

数値キーのインデックスを保持したい場合は、以下の方法を使用できます:

例

<?php
$arr = array('1'=>1,'2'=>2,'3'=>'3');

function array_kshift(&$arr)
{
  list($k) = array_keys($arr);
  $r  = array($k=>$arr[$k]);
  unset($arr[$k]);
  return $r;
}
array_kshift($arr);
print_r($arr);
?>

上記の例の出力結果は以下のとおりです:

Array
(
    [2] => 2
    [3] => 3
)

詳細情報:PHP 配列の最初の要素を削除



PHP Array ReferencePHP Array リファレンスマニュアル全体 その他の拡張