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.

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

Usage 3: The following example creates an array with three defined elements:

var myArray:Array = Array("firstElement", "secondElement", "thirdElement");
trace (myArray); // traces firstElement,secondElement,thirdElement
Unlike the Array class constructor, the Array() function does not use the keyword new .

Array function

Parameters

Returns

Example

See also