array_unshift

(PHP 4, PHP 5, PHP 7, PHP 8)

array_unshift 在數(shù)組開頭插入一個或多個單元

說明

array_unshift(array &$array, mixed ...$values): int

array_unshift() 將傳入的單元插入到 array 數(shù)組的開頭。注意單元是作為整體被插入的,因此傳入單元將保持同樣的順序。所有的數(shù)值鍵名將修改為從零開始重新計數(shù),所有的文字鍵名保持不變。

注意:

重置數(shù)組中的內(nèi)部指針,指向第一個元素。

參數(shù)

array

輸入的數(shù)組。

values

插入的變量。

返回值

返回 array 數(shù)組新的單元數(shù)目。

更新日志

版本 說明
7.3.0 現(xiàn)在可以只用一個參數(shù)來調(diào)用,之前至少需要兩個參數(shù)。

范例

示例 #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
)

參見

  • array_shift() - 將數(shù)組開頭的單元移出數(shù)組
  • array_push() - 將一個或多個單元壓入數(shù)組的末尾(入棧)
  • array_pop() - 彈出數(shù)組最后一個單元(出棧)