This documentation is archived and is not being maintained.

push Method

Visual Studio 2010

Appends new elements to an array, and returns the new length of the array.

Copy 
function push([item1 : Object [, ... [, itemN : Object]]]) : Number

item1, ... , itemN

Optional. New elements of the Array.

The push and pop methods enable you to simulate a stack, which uses the principle of last in, first out (LIFO) to store data.

The push method appends elements in the order in which they appear. If one of the arguments is an array, it is added as a single element. Use the concat method to join the elements from two or more arrays.

The following example illustrates the use of the push method.

Copy 
var my_array = new Array();

my_array.push (5, 6, 7);
my_array.push (8, 9);

var s = "";
var number;

number = my_array.pop();
while (number != undefined)
    {
    s += number + " ";
    number = my_array.pop();
    }

print (s);
// Output: 9 8 7 6 5
Show: