array_unshift
(PHP 4, PHP 5, PHP 7, PHP 8)
array_unshift — 在陣列開頭插入一個或多個單元
說明
array_unshift() 將傳入的單元插入到
array 陣列的開頭。注意單元是作為整體被插入的，因此傳入單元將保持同樣的順序。所有的數值鍵名將修改爲從零開始重新計數，所有的文字鍵名保持不變。
注意:
重置陣列中的內部指針，指向第一個元素。
參數
-
array -
輸入的陣列。
-
values -
插入的變數。
返回值
返回 array 陣列新的單元數目。
更新日誌
| 版本 | 說明 |
|---|---|
| 7.3.0 | 現在可以只用一個參數來呼叫，之前至少需要兩個參數。 |
範例
示例 #1 array_unshift() 例子
<?php
$queue = array("orange", "banana");
array_unshift($queue, "apple", "raspberry");
print_r($queue);
?>
以上例程會輸出：
Array
(
[0] => apple
[1] => raspberry
[2] => orange
[3] => banana
)