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

# 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

function 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 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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open