# PHP array_unshift() 函數 ## 定義和用法 array_unshift() 函數在數組開頭插入一個或多個元素。 被加上的元素作為一個整體添加，這些元素在數組中的順序和在參數中的順序一樣。 該函數會返回數組中元素的個數。 ### 語法 ``` array_unshift(array,value1,value2,value3...) ``` | 參數 | 描述 | | --- | --- | | array | 必需。規定輸入的數組。 | | value1 | 必需。規定插入的值。 | | value2 | 可選。規定插入的值。 | | value3 | 可選。規定插入的值。 | ## 提示和注釋 注釋：所有的數值鍵名將修改為從零開始重新計數，所有的字符串鍵名保持不變。 ## 例子 1 ``` <?php $a=array("a"=>"Cat","b"=>"Dog"); array_unshift($a,"Horse"); print_r($a); ?> ``` 輸出： ``` Array ( [0] => Horse [a] => Cat [b] => Dog ) ``` ## 例子 2 返回鍵值： ``` <?php $a=array("a"=>"Cat","b"=>"Dog"); print_r(array_unshift($a,"Horse")); ?> ``` 輸出： ``` 3 ``` ## 例子 3 數組帶有數值鍵： ``` <?php $a=array(0=>"Cat",1=>"Dog"); array_unshift($a,"Horse"); print_r($a); ?> ``` 輸出： ``` Array ( [0] => Horse [1] => Cat [2] => Dog ) ```