php教程，如何理解array_unshift()函数？数组头部插入元素

我们相信：世界是美好的，你是我也是。平行空间的世界里面，不同版本的生活也在继续...

unshift的英文翻译是“数组头部插入”，所以这个php中的函数array_unshift()，主要功能就是在元素的头部位置插入对应的元素。这就是望文生义的角度，来理解这个函数。那么，在实际的执行过程中，这个array_unshift()函数，有什么注意事项么？这就是本文的主要写作目的。

苏南大叔的“程序如此灵动”技术博客，记录苏南大叔的编程经验文章总结。本文测试环境：win10，nginx@1.15.11，php@8.2.10-nts。

函数原型

这里还是先引用最官方的说法，array_unshift()的函数原型是：

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

array_unshift() 将传入的单元插入到 array 数组的开头。注意单元是作为整体被插入的，因此传入单元将保持同样的顺序。所有的数值键名将修改为从零开始重新计数，所有的文字键名保持不变。

• https://www.php.net/manual/zh/function.array-unshift.php

简单例子

$list = array("苏南大叔", "site" => "newsn.net");
$ret = array_unshift($list, "sunan大叔", "苏贝大哥");
var_dump($list);
var_dump($ret);

输出：

array(4) {
  [0]=>
  string(11) "sunan大叔"
  [1]=>
  string(12) "苏贝大哥"
  [2]=>
  string(12) "苏南大叔"
  ["site"]=>
  string(9) "newsn.net"
}
int(4)

返回值

返回值，并不是想象中的数组变量本身。

• 返回值是数组内的元素个数！并不是数组本身！无法理解！为啥要返回元素个数？？？
• 数组本身直接被修改！请注意函数原型中第一个参数是引用类型！

重置数字索引

英文不好，所以无法理解到unshift的意思是“数组头部插入”。这里对这个函数的作用进行了统一明确。并且需要强调的是：

• 插入到数组头部后，新的值的数字索引被设置为0，原有的数字索引顺序加一！
• 如果索引是非数字的话，元素插入前后，索引是不变的！

可以插入多个元素

不是非要仅仅插入一个元素，而是可以插入多个元素。

相关文章

• https://newsn.net/say/js-inarray.html
• https://newsn.net/say/php-implode.html

结束语

感谢阅读！文件很简单，就是记录一下array_unshift()的注意事项！不知道读者是否想看更多php相关文章？请点击：

• https://newsn.net/tag/php/

如果本文对您有帮助，或者节约了您的时间，欢迎打赏瓶饮料，建立下友谊关系。
本博客不欢迎：各种镜像采集行为。请尊重原创文章内容，转载请保留作者链接。