array_push

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

array_pushApila 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.

Ejemplos

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
)

Ver también