PHP | función array_unshift()

Esta función incorporada de PHP se usa para agregar o más elementos en una array y estos elementos se agregan al comienzo de la array. Todos los elementos que agregamos a la array se insertan en el mismo orden en que se han pasado. Están indexados numéricamente a partir de la posición 0. Si hay claves de string, entonces permanecen sin cambios.
Sintaxis : 
 

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

Parámetros: 
La función puede tomar múltiples parámetros, dependiendo de la cantidad de elementos que queramos insertar en la array. Básicamente hemos clasificado los parámetros en dos categorías como se explica a continuación: 
 

1. $array: este es un parámetro obligatorio y se refiere a la array original sobre la que queremos operar.
2. List_of_values : este es un grupo de parámetros y representa una lista de valores que necesitamos insertar en la array, $array . En la sintaxis anterior, List_of_values ​​es $val1, $val2, $val3…. .

Valor devuelto: esta función devuelve el número total de elementos en la nueva array modificada después de insertar elementos.
Ejemplos: 
 

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
)

Los siguientes programas ilustran la función array_unshift() en PHP: 
 

• En este programa, intentaremos comprender el funcionamiento de la función array_unshift() agregando los elementos al principio de la array. También observaremos que las teclas numéricas se agregan automáticamente. 
   

<?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";
 
// Calling array_unshift()
array_unshift($array, $a1, $a2, $a3);
 
// Print modified array
print_r($array);
 
?>

• Producción: 
   

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

•  
• En el programa anterior, hemos visto que si se pasa una array sin teclas a la función array_unshift(), entonces se modifica automáticamente a una array con teclas numéricas. Pero si la array ya tenía claves numéricas que comienzan desde cero, luego de insertar nuevos elementos, las claves se modificarán. El siguiente programa ilustra esto: 
   

<?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);
 
?>

• Producción: 
   

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

Referencia : 
http://php.net/manual/en/function.array-unshift.php