array_unshift

定義和用法

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

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

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

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

註釋：數值鍵名將從0 開始，以1 遞增。字符串鍵名將保持不變。

實例

例子1

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

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

親自試一試

例子2

顯示返回值：

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

親自試一試

例子3

使用數字鍵名：

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

親自試一試

文法

array_unshift ( array , value1 , value2 , value3 ... )