PHP array_unshift()用法及代码示例

PHP的此内置函数用于在数组中添加一个或多个元素，并将这些元素添加到数组的开头。我们添加到数组中的所有元素都按传递的相同顺序插入。它们从第0位开始进行数字索引。如果有字符串键，则它们保持不变。

用法：

int array_unshift($array, $val1, $val2, $val3....)

参数：
该函数可以采用多个参数，具体取决于我们要插入数组的元素数量。我们本质上将参数分为两类，如下所述：

1. $array:这是必填参数，是指我们要操作的原始数组。
2. List_of_values：这是一组参数，代表我们需要在数组$array中插入的值的列表。在上面的语法中，List_of_values是$val1，$val2，$val3…。

返回值：插入元素后，此函数返回新修改后的数组中的元素总数。

例子：

Input : $array = ("ram", "krishna", "aakash")
        $val1 = "rohan", $val2 = "rajeeb", $val3 = "saniya"
Output :
Array
(
    [0] => rohan
    [1] => rajeeb
    [2] => saniya
    [3] => ram
    [4] => krishna
    [5] => aakash
)

Input : $array = (1=>"ram", 2=>"krishna", 3=>"aakash")
        $val1 = "rohan", $val2 = "rajeeb", $val3 = "saniya";
Output :
Array
(
    [0] => rohan
    [1] => rajeeb
    [2] => saniya
    [3] => ram
    [4] => krishna
    [5] => aakash
)

以下示例程序旨在说明PHP中的array_unshift()函数：

• 在此程序中，我们将通过将元素添加到数组的开头来尝试了解array_unshift()函数的工作方式。我们还将观察到数字键是自动添加的。

  <?php 
    
  // PHP program to illustrate  
  // the use of array_unshift() 
    
  // Input Array 
  $array = array("ram", "krishna", "aakash"); 
    
  // Values to be added 
  $a1 = "rohan"; 
  $a2 = "rajeeb"; 
  $a3 = "saniya"; 
    
  // Callig array_unshift() 
  array_unshift($array, $a1, $a2, $a3); 
    
  // Print modified array 
  print_r($array); 
    
  ?>

  输出：

  Array
  (
      [0] => rohan
      [1] => rajeeb
      [2] => saniya
      [3] => ram
      [4] => krishna
      [5] => aakash
  )

• 在上面的程序中，我们已经看到，如果将非键数组传递给array_unshift()函数，则会将其自动修改为带有数字键的数组。但是，如果数组已经具有从零开始的数字键，则在插入新元素之后，键将被修改。以下示例程序旨在说明这一点：

  <?php 
    
  // PHP program to illustrate  
  // the use of array_unshift() 
    
  // Input Array 
  $array = array(1=>"ram", 2=>"krishna", 3=>"aakash"); 
    
  // Values to be inserted 
  $a1 = "rohan"; 
  $a2 = "rajeeb"; 
  $a3 = "saniya"; 
    
  // Calling array_unshift() 
  array_unshift($array, $a1, $a2, $a3); 
    
  // Print modified array 
  print_r($array); 
    
  ?>

  输出：

  Array
  (
      [0] => rohan
      [1] => rajeeb
      [2] => saniya
      [3] => ram
      [4] => krishna
      [5] => aakash
  )
  

参考：
http://php.net/manual/en/function.array-unshift.php