A-C > Array.push

Array.push

array.push, push

Availability

Flash Player 5.

Usage

myArray.push(value,...)

Parameters

value One or more values to append to the array.

Returns

The length of the new array.

Description

Method; adds one or more elements to the end of an array and returns the array's new length.

Example

The following example creates the array myPets with two elements, cat and dog. The second line adds two elements to the array. After the push method is called, the variable pushed contains four elements. Because the push method returns the new length of the array, the trace action in the last line sends the new length of myPets (4) to the Output window:

myPets = ["cat", "dog"];
pushed = myPets.push("bird", "fish");
trace(pushed);