JScript
Enumerator Object (Windows Scripting - JScript)

Updated: March 2009

Enables enumeration of items in a collection.

enumObj = new Enumerator([collection]) 
Arguments

enumObj

Required. The variable name to which the Enumerator object is assigned.

collection

Optional. Any Collection object.

Remarks

Collections differ from arrays in that the members of a collection are not directly accessible. Instead of using indexes, as you would with arrays, you can only move the current item pointer to the first or next element of a collection.

The Enumerator object provides a way to access any member of a collection and behaves similarly to the For...Each statement in VBScript.

Example

The following code shows the usage of the Enumerator object:

   var fso = new ActiveXObject("Scripting.FileSystemObject");
   var e = new Enumerator(fso.Drives);
   var s = "";
   do
   {
      var x = e.item();

      s += x.DriveLetter;
      s += " - ";

      if (x.DriveType == 3)
         s += x.ShareName;
      else if (x.IsReady)
         s += x.VolumeName;
      else
         s += "[Drive not ready]";

      s += "<br />";
      
      e.moveNext();
   }
   while (!e.atEnd());

   document.write (s);
Properties

The Enumerator object has no properties.

Methods

atEnd Method | item Method | moveFirst Method | moveNext Method

Requirements

Version 3

See Also

Reference

Change History

Date

History

Reason

March 2009

Modified code example.

Information enhancement.

Tags :


Page view tracker