Flash CS3 Documentation

ActionScript 2.0 Language Reference > ActionScript classes > Array > push (Array.push method)

push (Array.push method)

Adds one or more elements to the end of an array and returns the new length of the array.

Availability: ActionScript 1.0; Flash Player 5

Parameters

value:Object - One or more values to append to the array.

Returns

Number - An integer representing the length of the new array.

Example

The following example creates the array myPets_array with two elements, cat and dog. The second line adds two elements to the array.

Because the push() method returns the new length of the array, the trace() statement in the last line sends the new length of myPets_array (4) to the Output panel.

var myPets_array:Array = new Array("cat", "dog");
var pushed:Number = myPets_array.push("bird", "fish");
trace(pushed); // Displays 4.

See also

pop (Array.pop method), shift (Array.shift method), unshift (Array.unshift method)

Flash CS3