Función PHP array_unshift()

La función array_unshift() en PHP se utiliza para agregar uno o más elementos al principio de un array existente. Los elementos existentes se desplazarán hacia adelante para hacer espacio para los nuevos elementos agregados.

Sintaxis de array_unshift()

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

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

Donde:

• array: El array en el que se agregará el elemento(s) al principio.
• value1, value2, value3, etc.: Los elementos que se agregarán al principio del array.

Ejemplos de uso

Supongamos que tenemos el siguiente array:

$frutas = array("manzana", "naranja", "plátano"); 

Si queremos agregar la fruta "mango" al principio del array, utilizamos la función array_unshift():

array_unshift($frutas, "mango");

Después de ejecutar esta línea de código, el array $frutas se verá así:

Array
(
    [0] => mango
    [1] => manzana
    [2] => naranja
    [3] => plátano
)

Si queremos agregar más de un elemento, simplemente los separamos por comas en la llamada de la función:

array_unshift($frutas, "papaya", "piña"); 

Ahora el array $frutas se verá así:

Array
(
    [0] => papaya
    [1] => piña
    [2] => mango
    [3] => manzana
    [4] => naranja
    [5] => plátano
)

Es importante tener en cuenta que al agregar elementos al principio de un array, los índices del array cambian para reflejar la nueva posición de cada elemento.

Usos comunes de array_unshift()

La función array_unshift() puede ser útil en varias situaciones, por ejemplo:

• Cuando necesitamos agregar un elemento al principio de un array que necesitamos mantener en orden.
• Cuando necesitamos agregar un elemento al principio de un array que utilizamos para iterar en un ciclo foreach.

Conclusión

La función array_unshift() nos permite agregar uno o más elementos al principio de un array existente en PHP. Los elementos existentes se desplazarán hacia adelante para hacer espacio para los nuevos elementos agregados. Está función es útil en situaciones donde necesitamos mantener los elementos de un array en un orden específico o al iterar en un ciclo foreach.

Ejemplo de código:

$frutas = array("manzana", "naranja", "plátano");
array_unshift($frutas, "mango");
print_r($frutas); // Output: Array ( [0] => mango [1] => manzana [2] => naranja [3] => plátano ) 

Preguntas frecuentes

¿Esta función elimina algún elemento del array?

No, la función array_unshift() no elimina ningún elemento del array. Simplemente añade nuevos elementos al principio del mismo.

¿Qué sucede si intentamos utilizar la función con un array vacío?

Si se utiliza la función array_unshift() con un array vacío, simplemente el primer elemento del array será el elemento que se está agregando al principio del array.

¿Puedo agregar elementos de diferentes tipos al array utilizando esta función?

Sí, se pueden agregar elementos de diferentes tipos al array utilizando la función array_unshift(). Por ejemplo, se puede agregar una cadena de texto, un número y un array.

Contar la longitud de un array en PHP

Cómo agregar días a una fecha en PHP

Contar la longitud de una cadena usando la función de PHP strlen()

Convertir un array en PHP a una cadena separada por comas

Creación de un Apache VirtualHost

Crear una aplicación de Laravel usando Sail y Docker

Escribir en un archivo en PHP usando fwrite()

Cómo agregar elementos a un array en PHP

Concatenación de cadenas en PHP