Función array_unshift() de PHP

Ejemplo

Insertar el elemento "blue" en el array:

<?php
$a=array("a"=>"red","b"=>"green");
array_unshift($a,"blue");
print_r($a);
?>

Ejemplo de ejecución

Definición y uso

La función array_unshift() se utiliza para insertar nuevos elementos en el array. Los valores del nuevo array se insertarán al principio del array.

Los elementos agregados se agregarán como un todo, y el orden de estos elementos en el array será el mismo que el orden en los parámetros.

Esta función devolverá el número de elementos en el array.

Consejos:Puede insertar uno o más valores.

Notas:Los nombres de clave numéricos comenzarán en 0, aumentando en 1. Los nombres de clave de cadena se mantendrán sin cambios.

Sintaxis

array_unshift(array,value1,value2,value3...)
Parámetros Descripción
array Obligatorio. Especificar el array.
value1 Obligatorio. Especificar el valor a insertar.
value2 Opcional. Especificar el valor a insertar.
value3 Opcional. Especificar el valor a insertar.

Detalles técnicos

Valor devuelto: Devuelve el número de nuevos elementos del array.
Versión PHP: 4+

Más ejemplos

Ejemplo 1

Mostrar valor devuelto:

<?php
$a=array("a"=>"red","b"=>"green");
print_r(array_unshift($a,"blue"));
?>

Ejemplo de ejecución

Ejemplo 2

Uso de nombres de clave numéricos:

<?php
$a=array(0=>"red",1=>"green");
array_unshift($a,"blue");
print_r($a);
?>

Ejemplo de ejecución