PHP array_unshift() 函數

實例

把元素 "blue" 插入數組中:

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

運行實例

定義和用法

array_unshift() 函數用于向數組插入新元素。新數組的值將被插入到數組的開頭。

被加上的元素作為一個整體添加,這些元素在數組中的順序和在參數中的順序一樣。

該函數會返回數組中元素的個數。

提示:您可以插入一個或多個值。

注釋:數值鍵名將從 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);
?>

運行實例