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); ?>
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 2
Uso de nombres de clave numéricos:
<?php $a=array(0=>"red",1=>"green"); array_unshift($a,"blue"); print_r($a); ?>