array_unshift()

1. 定义

与array_push()相反，该函数将一个或多个元素添加至数组的开头，返回添加元素后数组的长度。

2. 语法

array_unshift ( array &$array [, mixed $... ] ) : int

3. 参数说明

4. 示例

<?php

// array_unshift()
// 将一个或多个元素添加至数组的**开头**，返回添加元素后数组的长度

$arr = [1, 2, 3];
$val1 = '一个字符串';
$val2 = 23;
$val3 = [1=>'一个带索引的数组'];
$num = array_unshift($arr, $val1, $val2, $val3);
var_dump($num);// 输出：int(6)
var_dump($arr);
/* 输出：
array(6) {
  [0]=>
  string(15) "一个字符串"
  [1]=>
  int(23)
  [2]=>
  array(1) {
    [1]=>
    string(24) "一个带索引的数组"
  }
  [3]=>
  int(1)
  [4]=>
  int(2)
  [5]=>
  int(3)
}
*/

5. 延展阅读

• array_shift()：将数组开头的元素删除，并返回被删除的第一个元素
• array_push()：将一个或多个元素添加至数组的末尾
• array_pop()：删除数组的最后一个元素，返回删除的最后一个元素