MACROMEDIA FLASH MX 2004 - ACTIONSCRIPT, Reference Manual

Page: 278 / 816

278 Chapter 12: ActionScript Dictionary
Array.length
Availability
Flash Player 5.
Usage
my_array .length
Description
Property; a nonzero-based 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
.
Example
The following code explains how the
length
property is updated.
my_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
Array.pop()
Availability
Flash Player 5.
Usage
my_array .pop()
Parameters
None.
Returns
The value of the last element in the specified array.
Description
Method; removes the last element from an array and returns the value of that element.
Example
The following code creates the
myPets
array containing four elements, then removes its
last element.
myPets = ["cat", "dog", "bird", "fish"];
popped = myPets.pop();
trace(popped);
// returns fish