JScript  

for...in Statement

[This is preliminary documentation and subject to change]

Executes one or more statements for each property of an object, or each element of an array.

for (variable in [object | array])
   statements

Arguments

variable

Required. A variable that can be any property of an object or any element of an array.

object, array

Optional. An object or array over which to iterate.

statements

Optional. One or more statements to be executed for each property of object or each element of array. Can be a compound statement.

Remarks

Before each iteration of a loop, variable is assigned the next property of object or the next element of array. You can then use it in any of the statements inside the loop, exactly as if you were using the property of object or the element of array.

When iterating over an object, there is no way to determine or control the order in which the members of the object are assigned to variable. Iterating through an array will be performed in element order, that is, 0, 1, 2, ...

Example

The following example illustrates the use of the for ... in statement with an object used as an associative array.

function ForInDemo(){
   // Create some variables.
   var a, key, s = "";
   // Initialize object.
   a = {"a" : "Athens" , "b" : "Belgrade", "c" : "Cairo"}
   // Iterate the properties.
   for (key in a)   {
      s += a[key] + "&ltBR>";
   }
   return(s);
}

Note   Use the enumerator object to iterate members of a collection.

Requirements

Version 5

See Also

for Statement | while Statement