PHP array_unshift() 函数

实例

把元素 "blue" 插入数组中:

  1. <!doctype html>
  2. <html>
  3. <body>
  4. <?php
  5. $a=array("a"=>"red","b"=>"green");
  6. array_unshift($a,"blue");
  7. print_r($a);
  8. ?>
  9. </body>
  10. </html>

定义和用法

array_unshift() 函数用于向数组插入新元素。新数组的值将被插入到数组的开头。

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

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

提示:您可以插入一个或多个值。

注释:数值键名将从 0 开始,以 1 递增。字符串键名将保持不变。


语法

  1. array_unshift(array,value1,value2,value3...)
参数描述
array必需。规定数组。
value1必需。规定要插入的值。
value2可选。规定要插入的值。
value3可选。规定要插入的值。

技术细节

返回值:返回数组中新的元素数目。
PHP 版本:4+

更多实例

例子 1

显示返回值:

  1. <!doctype html>
  2. <html>
  3. <body>
  4. <?php
  5. $a=array("a"=>"red","b"=>"green");
  6. print_r(array_unshift($a,"blue"));
  7. ?>
  8. </body>
  9. </html>
例子 2

使用数字键名:

  1. <!doctype html>
  2. <html>
  3. <body>
  4. <?php
  5. $a=array(0=>"red",1=>"green");
  6. array_unshift($a,"blue");
  7. print_r($a);
  8. ?>
  9. </body>
  10. </html>

分类导航