(PHP 4, PHP 5, PHP 7, PHP 8)
array_push — Apila uno o más elementos al final de un array
array_push() considera array
como una pila, y apila las variables values
al final de array
.
La longitud del array array
aumenta en consecuencia.
Esto tiene el mismo efecto que:
<?php
$array[] = $var;
?>
Nota: Si se utiliza la función array_push() para añadir un elemento a un array, es preferible reemplazarla por el operador
$array[] =
que evita el paso por una función.
Nota: array_push() emitirá una alerta si el primer argumento no es un array. Esto difiere del comportamiento de
$var[]
donde un nuevo array era creado, anteriormente a PHP 7.1.0.
array
El array de entrada.
values
El valor a insertar al final del array
array
.
Devuelve el nuevo número de elementos en el array.
Versión | Descripción |
---|---|
7.3.0 | Esta función puede ahora ser llamada con un solo parámetro. Anteriormente, se requerían al menos dos parámetros. |
Ejemplo #1 Ejemplo con array_push()
<?php
$stack = array("orange", "banana");
array_push($stack, "apple", "raspberry");
print_r($stack);
?>
El resultado del ejemplo sería:
Array ( [0] => orange [1] => banana [2] => apple [3] => raspberry )