array_push

(PHP 4, PHP 5, PHP 7, PHP 8)

array_push — Apila uno o más elementos al final de un array

Descripción

array_push(array &$array, mixed ...$values): int

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;
?>

repetido para cada valor.

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.

Parámetros

array: El array de entrada.
values: El valor a insertar al final del array array.

Valores devueltos

Devuelve el nuevo número de elementos en el array.

Historial de cambios

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.

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.

Ejemplos

Ejemplo #1 Ejemplo con array_push()

<?php
$stack = array("orange", "banana");
array_push($stack, "apple", "raspberry");
print_r($stack);
?>

El ejemplo anterior mostrará:

Array
(
    [0] => orange
    [1] => banana
    [2] => apple
    [3] => raspberry
)

Ver también

array_pop() - Desapila un elemento del final de un array
array_shift() - Despila un elemento al principio de un array
array_unshift() - Empila uno o más elementos al inicio de un array