Función PHP array_unshift()
Ejemplo
Inserte el elemento "azul" en una matriz:
<?php
$a=array("a"=>"red","b"=>"green");
array_unshift($a,"blue");
print_r($a);
?>
Definición y uso
La función array_unshift() inserta nuevos elementos en una matriz. Los nuevos valores de matriz se insertarán al principio de la matriz.
Sugerencia: puede agregar un valor o tantos como desee.
Nota: Las teclas numéricas comenzarán en 0 y aumentarán en 1. Las teclas de cadena seguirán siendo las mismas.
Sintaxis
array_unshift(array, value1, value2, value3, ...)
Valores paramétricos
Parameter | Description |
---|---|
array | Required. Specifying an array |
value1 | Optional. Specifies a value to insert (Required in PHP versions before 7.3) |
value2 | Optional. Specifies a value to insert |
value3 | Optional. Specifies a value to insert |
Detalles técnicos
Valor devuelto: | Devuelve el nuevo número de elementos de la matriz. |
---|---|
Versión PHP: | 4+ |
Registro de cambios de PHP: | PHP 7.3: ahora se puede llamar a esta función solo con el parámetro de matriz |
Más ejemplos
Ejemplo
Mostrar el valor devuelto:
<?php
$a=array("a"=>"red","b"=>"green");
print_r(array_unshift($a,"blue"));
?>
Ejemplo
Usando teclas numéricas:
<?php
$a=array(0=>"red",1=>"green");
array_unshift($a,"blue");
print_r($a);
?>
❮ Referencia de matriz de PHP