User Guide

Array class 103
Array class
Availability
Flash Player 5 (became a native object in Flash Player 6, which improved
performance significantly).
Description
The Array class lets you access and manipulate arrays. An array is an object whose properties are
identified by a number representing their position in the array. This number is referred to as the
index. All arrays are zero-based, which means that the first element in the array is [0], the second
element is [1], and so on. To create an Array object, you use the constructor
new Array(). To
access the elements of an array, you use the array access (
[]) operator.
In the following example,
my_array contains four months of the year:
var my_array:Array = new Array();
my_array[0] = "January";
my_array[1] = "February";
my_array[2] = "March";
my_array[3] = "April";
Method summary for the Array class
Property summary for the Array class
Method Description
Array.concat()
Concatenates the parameters and returns them as a new array.
Array.join()
Joins all elements of an array into a string.
Array.pop()
Removes the last element of an array and returns its value.
Array.push()
Adds one or more elements to the end of an array and returns the array’s new
length.
Array.reverse()
Reverses the direction of an array.
Array.shift()
Removes the first element from an array and returns its value.
Array.slice()
Extracts a section of an array and returns it as a new array.
Array.sort()
Sorts an array in place.
Array.sortOn()
Sorts an array according to a field in the array.
Array.splice()
Adds and removes elements from an array.
Array.toString()
Returns a string value representing the elements in the Array object.
Array.unshift()
Adds one or more elements to the beginning of an array and returns the array’s
new length.
Property Description
Array.length
A non-negative integer specifying the number of elements in the array.
CHAPTER 2
ActionScript Language Reference