Añadir al inicio de un array uno a más elementos

Descripción

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

array_unshift() añade los elementos pasados al inicio de array. Observe que la lista de elementos se añade como un todo, por lo que los elementos añadidos permanecen en el mismo orden. Todas las claves numéricas del array serán modificadas empezando a contar desde cero mientras que las claves literales no serán cambiadas.

Parámetros

array: El array de entrada.
...: Los valores a añadir al inicio.

Valores devueltos

Devuelve el nuevo número de elementos del array.

Historial de cambios

Versión	Descripción
7.3.0	Esta función ahora puede ser llamada con un solo parámetro. Anteriormente, se requerían al menos dos parámetros.

Ejemplos

Ejemplo #1 Ejemplo de array_unshift()


<?php
$cola = array("naranja", "banana");
array_unshift($cola, "manzana", "frambuesa");
print_r($cola);
?>

El resultado del ejemplo sería:

Array
(
    [0] => manzana
    [1] => frambuesa
    [2] => naranja
    [3] => banana
)

Ver también

array_shift() - Quita un elemento del principio del array
array_push() - Inserta uno o más elementos al final de un array
array_pop() - Extrae el último elemento del final del array