MACROMEDIA FLASH MX 2004 - ACTIONSCRIPT Reference Manual page 245

Returns
Nothing.
Description
Operator; initializes a new array or multidimensional array with the specified elements (
on), or accesses elements in an array. The array access operator lets you dynamically set and
retrieve instance, variable, and object names. It also lets you access object properties.
Usage 1: An array is an object whose properties are called elements, which are each identified by a
number called an index. When you create an array, you surround the elements with the array
access operator (or brackets). An array can contain elements of various types. For example, the
following array, called
strings (inside quotation marks).
employee = [15, "Barbara", "Erick"];
Usage 2: You can nest brackets to simulate multidimensional arrays. The following code creates
an array called
ticTacToe
ticTacToe = [[1,2,3],[4,5,6],[7,8,9]];
// choose Debug > List Variables in test movie mode
// to see a list of the array elements
Usage 3: Surround the index of each element with brackets to access it directly; you can add a new
element to an array, change or retrieve the value of an existing element. The first element in an
array is always 0:
my_array[0] = 15;
my_array[1] = "Hello";
my_array[2] = true;
You can use brackets to add a fourth element, as in the following:
my_array[3] = "George";
Usage 4: You can use brackets to access an element in a multidimensional array. The first set of
brackets identifies the element in the original array, and the second set identifies the element in
the nested array. The following line of code sends the number 6 to the Output panel.
ticTacToe = [[1,2,3],[4,5,6],[7,8,9]];
trace(ticTacToe[1][2]);
// returns 6
Usage 5: You can use the array access operator instead of the
retrieve values for movie clip names or any property of an object:
name["mc" + i] = "left_corner";
Example
Usage 1: The following code samples show two different ways of creating a new empty Array
object; the first line uses brackets.
my_array =[];
my_array = new Array();
, has three elements; the first is a number and the second two are
employee
with three elements; each element is also an array with three elements.
function to dynamically set and
eval
[] (array access)
, and so
a0
245