Definition and Usage
定义和用法

The array_unshift() function inserts new elements to an array. The new array values will be inserted in the beginning of the array. The function's return value is the new number of elements in the array (See example 2).
array_unshift()函数的作用是在一个数组中插入新的元素。而这个新的数组将被添加到原数组的开头部分。函数最终返回的是插入新元素后的数组。

Syntax
语法

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

Tips and Notes
提示和注意点

Tip: You can add one value, or as many as you like.
提示：你可以添加一个或多个值。

Note: Numeric keys will start at 0 and increas by 1 (See example3). String keys will remain the same (See example 1).
注意：数值键将从0开始以基数1递增（见案例3）；字符键保持不变（见案例1）

Example 1
案例1

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

The output of the code above will be:
上述代码将返回下面的结果：

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

Example 2
案例2

Return value:
返回的值：

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

The output of the code above will be:
上述代码将返回下面的结果：

3

Example 3
案例3

Numeric keys:
数值键：

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

The output of the code above will be:
上述代码将返回下面的结果：

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

评论 (0) All