数组函数

PHP array_unshift() 函数

主题:PHP 数组参考上一页|下一页

说明

array_unshift() 函数在数组的开头插入一个或多个元素。

所有数字数组键都将被修改为从零开始计数。 字符串键将保持不变。

下表总结了该函数的技术细节。

返回值: 返回数组中新的元素个数。
变更日志: 从 PHP 7.3.0 开始,现在可以只使用一个参数(即 array)调用此函数。 以前,至少需要两个参数。
版本: PHP 4+

语法

array_unshift() 函数的基本语法如下:

array_unshift(array, value1, value2, ...);

以下示例显示了 array_unshift() 函数的作用。

<?php
// 样本数组
$colors = array("red", "green", "blue");

// 在颜色数组中添加两个值
array_unshift($colors, "yellow", "orange");
print_r($colors);
?>

参数

array_unshift() 函数接受以下参数。

参数 说明
array 必填。 指定要处理的数组。
value1, value2, ... 可选。 指定要添加到数组开头的值。

更多示例

这里有更多示例展示了 array_unshift() 函数的实际工作原理:

您还可以将值添加到关联数组中,如下所示:

<?php
// 样本数组
$alphabets = array("a"=>"apple", "b"=>"ball", "c"=>"cat", "d"=>"dog");

// 将单个值添加到字母数组
array_unshift($alphabets, "elephant");
print_r($alphabets);
?>
Advertisements