PHP | función array_push()

Esta función incorporada de PHP se usa para insertar nuevos elementos en una array. Podemos insertar uno o más de un elemento en la array y estos elementos se insertan al final de la array y debido a los elementos insertados en la array, la longitud de la array también se incrementa por la cantidad de elementos insertados en la array. .

Sintaxis :

array_push($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. Podemos clasificar los parámetros en dos categorías como se muestra a continuación:

1. $array: este parámetro se refiere a la array original sobre la que queremos operar.
2. Lista de valores: este parámetro se refiere a la lista de elementos separados por comas que queremos insertar en la array. En la sintaxis anterior, la lista de valores a enviar es $val1, $val2, $val3….

Valor de retorno: esta función devuelve la array modificada, con todos los elementos empujados al final de la array.

Nota: Si la array tiene un par clave-valor, entonces el método siempre agregará una clave numérica al valor insertado.

Ejemplos:

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

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

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

• En el siguiente programa, la función array_push() se usa para insertar nuevos elementos en una array sin claves.

  <?php // PHP code to illustrate the use of array_push()    // Input array $array = array("ram", "krishna", "aakash");    // elements to push $a1 = "rohan"; $a2 = "rajeeb"; $a3 = "saniya";    // array after pushing new elements print_r(array_push($array, $a1, $a2, $a3)); ?>

  Producción:

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

• En el siguiente programa, entenderemos cómo funciona la función array_push() con una array que tiene un par clave_valor ya definido.

  <?php // PHP code to illustrate the use of array_push()    // Input Array $array = array(1=>"ram", 2=>"krishna", 3=>"aakash");    // Elements to push $a1 = "rohan"; $a2 = "rajeeb"; $a3 = "saniya";    // Array after pushing new elements print_r(array_push($array, $a1, $a2, $a3)); ?>

  Producción:

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

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