PHP 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 )