PHP Manual
Prev |  | Next

# array_push

(PHP 4, PHP 5)

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

## Description

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:

`<?php $array[] = $var; ?>`

repeated for each var.

Returns the new number of elements in the array.

Example 1. array_push() example
`<?php $stack = array("orange", "banana"); array_push($stack, "apple", "raspberry"); print_r($stack); ?>`
This example would result in $stack having the following elements:
`Array ( [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().

Prev | Home | Next
array_product | Up | array_rand