【php数组函数序列】之array_unshift() - 在数组开头插入一个或多个元素

array_unshift()定义和用法

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

被加上的元素作为一个整体添加，这些元素在数组中的顺序和在参数中的顺序一样。

该函数会返回数组中元素的个数。

语法

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

参数	描述
array	必需。规定输入的数组。
value1	必需。规定插入的值。
value2	可选。规定插入的值。
value3	可选。规定插入的值。

提示和注释

注释：所有的数值键名将修改为从零开始重新计数，所有的字符串键名保持不变。

例子 1

<?php
$a=array("a"=>"Cat","b"=>"Dog");
array_unshift($a,"Horse");
print_r($a);
?>

输出：

Array ( [0] => Horse [a] => Cat [b] => Dog )

例子 2

返回键值：

<?php
$a=array("a"=>"Cat","b"=>"Dog");
print_r(array_unshift($a,"Horse"));
?>

输出：

3

例子 3

数组带有数值键：

<?php
$a=array(0=>"Cat",1=>"Dog");
array_unshift($a,"Horse");
print_r($a);
?>

输出：

Array ( [0] => Horse [1] => Cat [2] => Dog )