PHP array_unshift() 函數詳解：如何將元素插入數組開頭

M66 2025-06-12

PHP array_unshift() 函數詳解：如何將元素插入數組開頭

在PHP開發中，數組是一種非常常用的數據結構。當我們需要將新的元素插入到數組的開頭時，可以使用PHP中的array_unshift()函數。本文將介紹array_unshift()函數的用法，幫助你更好地理解並應用這一功能。

array_unshift()函數介紹

array_unshift()函數用於在數組的開頭插入一個或多個元素，並會改變數組的長度。插入後，原有的元素會依次向後移動。

array_unshift()函數語法

array_unshift(array &$array, mixed $value1 [, mixed $... ])

參數說明：

&$array : 必需。要操作的數組，使用引用傳遞。
$value1 : 必需。要插入的元素，可以是一個或多個。

示例代碼

下面是一個簡單的示例，展示瞭如何使用array_unshift()向數組的開頭插入元素：

<?php
$fruit = array("apple", "banana", "orange");

echo "原數組：";
print_r($fruit);

array_unshift($fruit, "lemon");

echo "插入後的新數組：";
print_r($fruit);
?>

在上述示例中，我們首先創建了一個包含3個水果元素的數組$fruit 。接著，我們使用array_unshift()函數將"lemon"插入到數組的開頭，並通過print_r()函數打印出數組的變化。

輸出結果：

運行代碼後，輸出結果如下：

原數組：
(

[0] => apple
[1] => banana
[2] => orange

)

插入後的新數組：
(

[0] => lemon
[1] => apple
[2] => banana
[3] => orange

)

從上面的輸出結果可以看出，array_unshift()成功地將"lemon"插入到數組的開頭，而原有的元素則依次向後移動。

返回值

需要注意的是，array_unshift()函數會返回插入元素後的新數組長度，而不是修改後的數組本身。

插入多個元素

除了插入單個元素外，array_unshift()函數也支持一次性插入多個元素。以下是一個示例：

<?php
$numbers = array(4, 5);

echo "原數組：";
print_r($numbers);

array_unshift($numbers, 1, 2, 3);

echo "插入後的新數組：";
print_r($numbers);
?>

運行以上代碼後，輸出結果如下：

原數組：
(

[0] => 4
[1] => 5

)

插入後的新數組：
(

[0] => 1
[1] => 2
[2] => 3
[3] => 4
[4] => 5

)

從這個示例可以看到，array_unshift()函數可以同時插入多個元素到數組的開頭，數組的長度隨之變化。

總結

array_unshift()函數是PHP中常用的數組操作函數，它使得我們可以方便地向數組的開頭插入一個或多個元素。掌握這個函數後，我們在開發中就可以靈活地操作數組，滿足不同需求。

print_r