array_push

(PHP 4, PHP 5, PHP 7)

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

Descripción

array_push ( array &$array , mixed $value1 [, mixed $... ] ) : int

array_push() trata array como si fuera una pila y coloca la variable que se le proporciona al final del array. El tamaño del array será incrementado por el número de variables insertados. Tiene el mismo efecto que:

<?php
$array[] = $var;
?>
repetido por cada valor proporcionado.

Nota: Si se utiliza array_push() para añadir un solo elemento al array, es mejor utilizar $array[] = ya que de esta forma no existe la sobrecarga de llamar a una función.

Nota: array_push() generará una advertencia si el primer argumento no es un array. Esto difiere del comportamiento de $var[] donde se creará un nuevo array.

Parámetros

array

El array de entrada.

value1

El primer valor a colocar al final de array.

Valores devueltos

Devuelve el nuevo número de elementos del array.

Ejemplos

Ejemplo #1 Ejemplo de array_push()

<?php
$pila = array("naranja", "plátano");
array_push($pila, "manzana", "arándano");
print_r($pila);
?>

El resultado del ejemplo sería:

Array
(
    [0] => naranja
    [1] => plátano
    [2] => manzana
    [3] => arándano
)

Ver también