MACROMEDIA FLASH 8-ACTIONSCRIPT 2.0 LANGUAGE, Reference

Page: 247 / 1378

Array 247
Methods inherited from class Object
Array constructor
public Array([value:Object])
Lets you create an array. You can use the constructor to create different types of arrays: an
empty array, an array with a specific length but whose elements have undefined values, or an
array whose elements have specific values.
Usage 1: If you don't specify any parameters, an array with a length of 0 is created.
Usage 2: If you specify only a length, an array is created with
length
number of elements.
The value of each element is set to
undefined
.
Usage 3: If you use the
element
parameters to specify values, an array is created with specific
values.
Availability: ActionScript 1.0; Flash Player 5
Parameters
value :Object
[optional] - Either:
■
An integer that specifies the number of elements in the array.
■
A list of two or more arbitrary values. The values can be of type Boolean, Number, String,
Object, or Array. The first element in an array always has an index or position of 0.
Example
Usage 1: The following example creates a new
Array
object with an initial length of 0:
var my_array:Array = new Array();
trace(my_array.length); // Traces 0.
Usage 2: The following example creates a new Array object with an initial length of 4:
var my_array:Array = new Array(4);
trace(my_array.length); // Returns 4.
trace(my_array[0]); // Returns undefined.
addProperty (Object.addProperty method)
,
hasOwnProperty
(Object.hasOwnProperty method)
,
isPropertyEnumerable
(Object.isPropertyEnumerable method)
,
isPrototypeOf (Object.isPrototypeOf
method)
,
registerClass (Object.registerClass method)
,
toString
(Object.toString method)
,
unwatch (Object.unwatch method)
,
valueOf
(Object.valueOf method)
,
watch (Object.watch method)
NO
TE
If only a single numeric parameter is passed to the Array constructor, it is assumed to be
length and it is converted to an integer by using the
integer()
function.