push

Summary

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

Syntax

push([ item1  [ item2 [. . . [ itemN ]]]])

item, item2,. . ., itemN: Optional. New elements of the Array.

Examples

The following example illustrates the use of the push method.

var number;
 var my_array = new Array();

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

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

 // Output:
 // 9 8 7 6 5

Remarks

The push and pop methods allow you to simulate a last in, first out stack.

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.

Attributions

Microsoft Developer Network: Article