MACROMEDIA FLASH 8-ACTIONSCRIPT 2.0 LANGUAGE, Reference

Page: 211 / 1378

Statements 211
for..in statement
for ( variableIterant in object ) {
statement(s);
}
Iterates over the properties of an object or elements in an array and executes the
statement
for each property or element. Methods of an object are not enumerated by the
for..in
action.
Some properties cannot be enumerated by the
for..in
action. For example, movie clip
properties, such as
_x
and
_y
, are not enumerated. In external class files, static members are
not enumerable, unlike instance members.
The
for..in
statement iterates over properties of objects in the iterated object's prototype
chain. Properties of the object are enumerated first, then properties of its immediate
prototype, then properties of the prototype's prototype, and so on. The
for..in
statement
does not enumerate the same property name twice. If the object
child
has prototype
parent
and both contain the property
prop
, the
for..in
statement called on
child
enumerates
prop
from
child
but ignores the one in
parent
.
The curly braces (
{}
) that are used to enclose the block of statements to be executed by the
for..in
statement are not necessary if only one statement is executed.
If you write a
for..in
loop in a class file (an external AS file), then instance members are not
available for the loop, but static members are. However, if you write a
for..in
loop in a FLA
file for an instance of the class, then instance members are available but static ones are not.
Availability: ActionScript 1.0; Flash Player 5
Parameters
variableIterant :String
- The name of a variable to act as the iterant, referencing each
property of an object or element in an array.
Example
The following example uses
for..in
to iterate over the properties of an object:
var myObject:Object = {firstName:"Tara", age:27, city:"San Francisco"};
for (var prop in myObject) {
trace("myObject."+prop+" = "+myObject[prop]);
}
//output
myObject.firstName = Tara
myObject.age = 27
myObject.city = San Francisco