PHP Manual: array_push

Enter the keyword for better results


(PHP 4, PHP 5)

array_push -- Push one or more elements onto the end of array


int array_push ( array &array, mixed var [, mixed ...] )

array_push() treats array as a stack, and pushes the passed variables onto the end of array. The length of array increases by the number of variables pushed. Has the same effect as:

[] = $var;
repeated for each var.

Returns the new number of elements in the array.

Example 1. array_push() example

= array("orange", "banana");
array_push($stack, "apple", "raspberry");

The above example will output:

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

Note: If you use array_push() to add one element to the array it's better to use $array[] = because in that way there is no overhead of calling a function.

Note: array_push() will raise a warning if the first argument is not an array. This differs from the $var[] behaviour where a new array is created.

See also array_pop(), array_shift(), and array_unshift().