User Guide

38 ActionScript language elements
Array function
Array(): Array Array(numElements:Number): Array Array( [element0:Object [,
element1, element2, ...elementN] ]) : Array
Creates a new array of length zero or more, or an array populated by a list of specified
elements, possibly of different data types.
Lets you create one of the following:
■ an empty array
■ an array with a specific length but whose elements have undefined values
■ an array whose elements have specific values.
Using this function is similar to creating an array with the Array constructor (see
"Constructor for the Array class").
You can pass a number (
numElements) or a list of elements comprising one or more different
types (
element0, element1, ... elementN).
Parameters that can accept more than one data type are listed as in the signature as type
Object.
Availability: ActionScript 1.0; Flash Lite 2.0
Parameters
numElements [optional] - A positive integer that specifies the number of elements in the
array. You can specify either numElements or the list of elements, not both.
elementN [optional] - one or more parameters, element0, element1, ... , elementN,
the values of which can be of any type. Parameters that can accept more than one data type are
listed as type
Object. You can specify either numElements or the list of elements, not both.
Returns
Array - An array.
Example
var myArray:Array = Array();
myArray.push(12);
trace(myArray); //traces 12
myArray[4] = 7;
trace(myArray); //traces 12,undefined,undefined,undefined,7
Usage 2: The following example creates an array of length 4 but with no elements defined:
var myArray:Array = Array(4);
trace(myArray.length); // traces 4
trace(myArray); // traces undefined,undefined,undefined,undefined