MACROMEDIA Flash Lite 2, Справочник

Страница: 38 / 780

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