Array.push( ) Method

	ActionScript for Flash MX: The Definitive Guide, 2nd Edition By Colin Moock
	Chapter 18.  ActionScript Language Reference

Array.push( ) Method

Flash 5

---

add one or more elements to the end of an array

array.push(value1, value2,...valuen)

Arguments

value1, ...valuen

A list of one or more values to be added to the end of array.

Returns

The new length of array.

Description

The push( ) method appends a list of values to the end of an array as new elements. Elements are added in the order provided. It differs from concat( ) in that push( ) modifies the original array, whereas concat( ) creates a new array. It differs from unshift( ) in that push( ) adds elements at the end of an array, not the beginning.

Example

myList = new Array (5, 6); myList.push(7);             // myList is now [5, 6, 7] myList.push(10, 8, 9);      // myList is now [5, 6, 7, 10, 8, 9]

See Also

Array.concat( ), Array.pop( ), Array.unshift( ); "Adding Elements to an Array," in Chapter 11