array_push

(PHP 4, PHP 5)

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

Descripción

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

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

array_pop() - Extrae el último elemento del final del array
array_shift() - Quita un elemento del principio del array
array_unshift() - Añadir al inicio de un array uno a más elementos