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