PHP array_unshift() 関数

要素 "blue" を配列に挿入:

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

実行例

定義と使用法

array_unshift() 関数は新しい要素を配列に挿入するために使用されます。新しい配列の値は配列の先頭に挿入されます。

追加された要素は一括で追加され、これらの要素の配列内の順序はパラメータ内の順序と同じです。

この関数は配列の要素数を返します。

ヒント:1つまたは複数の値を挿入できます。

注釈:数値キーは 0 から始まり、1 で増加します。文字列キーは変更されません。

構文

array_unshift(array,value1,value2,value3...)
パラメータ 説明
array 必須。配列を指定します。
value1 必須。挿入する値を指定します。
value2 オプション。挿入する値を指定します。
value3 オプション。挿入する値を指定します。

技術的詳細

返される値: 新しい要素の数を返します。
PHP バージョン: 4+

さらに例

例 1

返される値を表示:

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

実行例

例 2

デジタルキーを使用:

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

実行例