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