MACROMEDIA FLASH 8-ACTIONSCRIPT 2.0 LANGUAGE, Reference

Page: 251 / 1378

Array 251
trace(a_array.join(" + "));
// Displays Earth + Moon + Sun.
The following example creates a nested array that contains two arrays. The first array has three
elements: Europa, Io, and Callisto. The second array has two elements: Titan and Rhea. It
joins the array by using a plus sign (+), but the elements within each nested array remain
separated by commas (,).
var a_nested_array:Array = new Array(["Europa", "Io", "Callisto"],
["Titan", "Rhea"]);
trace(a_nested_array.join(" + "));
// Returns Europa,Io,Ca Titan,Rhea.
See also
split (String.split method)
length (Array.length property)
public length : Number
A non-negative integer specifying the number of elements in the array. This property is
automatically updated when new elements are added to the array. When you assign a value to
an array element (for example,
my_array[index] = value
), if
index
is a number, and
index+1
is greater than the
length
property, the
length
property is updated to
index+1
.
Availability: ActionScript 1.0; Flash Player 5
Example
The following code explains how the
length
property is updated. The initial length is 0, and
then updated to 1, 2, and 10. If you assign a value to the
length
property that is shorter than
the existing length, the array will be truncated:
var my_array:Array = new Array();
trace(my_array.length); // initial length is 0
my_array[0] = "a";
trace(my_array.length); // my_array.length is updated to 1
my_array[1] = "b";
trace(my_array.length); // my_array.length is updated to 2
my_array[9] = "c";
trace(my_array.length); // my_array.length is updated to 10
trace(my_array);
// displays:
NO
T
E
If you assign a value to the
length
property that is shorter than the existing length, the
array will be truncated.