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);