Saltar al contenido

array_unshift()

¿Buscas una función potente para agregar nuevos elementos al principio de un array en PHP? No busques más allá de la función array_unshift(). Con esta función, puedes agregar fácilmente uno o más elementos al principio de un array, reindexando automáticamente las claves numéricas y desplazando los elementos existentes a posiciones más altas.

¿Qué es array_unshift()?

La función array_unshift() es una función integrada en PHP que se utiliza para agregar uno o más elementos al principio de un array. Esta función no reemplaza los elementos existentes en el array, sino que los mueve a una posición de índice más alta para acomodar los nuevos elementos.

Sintaxis:

La sintaxis de la función array_unshift() es:

Sintaxis de PHP para array_unshift()

php
array_unshift(array, value1, value2, value3...)

El parámetro array se pasa por referencia y se modifica en su lugar. Los parámetros value1, value2, value3, etc. son los valores que deseas agregar al principio del array. La función devuelve el nuevo número de elementos en el array.

Ejemplo:

Veamos un ejemplo de cómo usar la función array_unshift():

Ejemplo de PHP de cómo usar array_unshift()

php
<?php

$fruits = array("apple", "banana", "cherry");
array_unshift($fruits, "orange", "lemon");
print_r($fruits);

?>

En este ejemplo, primero definimos un array llamado $fruits, que contiene tres elementos: "apple", "banana" y "cherry". Luego usamos la función array_unshift() para agregar dos nuevos elementos al principio del array: "orange" y "lemon". Finalmente, usamos la función print_r() para mostrar el contenido del array modificado. La salida será:


console
Array
(
    [0] => orange
    [1] => lemon
    [2] => apple
    [3] => banana
    [4] => cherry
)

Ventajas de array_unshift():

Existen varias ventajas al usar la función array_unshift(). Aquí tienes algunos de los principales beneficios:

  1. Reindexación automática de claves: La función desplaza automáticamente las claves numéricas a posiciones más altas, por lo que no es necesario reindexar manualmente el array.
  2. Fácil de agregar nuevos elementos: Con la función array_unshift(), puedes agregar fácilmente nuevos elementos al principio de un array, sin preocuparte por sobrescribir elementos existentes o causar problemas con las posiciones de índice del array.
  3. Más eficiente que la reindexación manual: Si reindexaras manualmente un array para agregar nuevos elementos al principio, sería un proceso lento e ineficiente. Con la función array_unshift(), puedes lograr la misma tarea en solo una línea de código.

Conclusión:

En conclusión, la función array_unshift() es una herramienta potente para agregar nuevos elementos al principio de un array en PHP. Con su sintaxis fácil de usar y su funcionalidad eficiente, es una excelente opción para desarrolladores que necesitan agregar nuevos elementos a un array sin sobrescribir elementos existentes o reindexar todo el array. ¡Así que adelante, pruébala en tu próximo proyecto PHP!

Práctica

¿Cuál es el propósito de la función array_unshift en PHP?

¿Te resulta útil?

Vista previa dual-run — compárala con las rutas Symfony en producción.