Share via


Enumerator Object (JScript 5.6) 

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:

function ShowDriveList(){

   var fso, s, n, e, x;                     //Declare variables.

   fso = new ActiveXObject("Scripting.FileSystemObject");

   e = new Enumerator(fso.Drives);          //Create Enumerator on Drives.

   s = "";

   for (;!e.atEnd();e.moveNext())           //Enumerate drives collection.

      {

         x = e.item();

         s = s + x.DriveLetter;

         s += " - ";

         if (x.DriveType == 3)              //See if network drive.

            n = x.ShareName;                //Get share name

         else if (x.IsReady)                //See if drive is ready.

            n = x.VolumeName;               //Get volume name.

         else

            n = "[Drive not ready]";

         s +=  n + "<br>";

      }

   return(s);                               //Return active drive list.

}

Properties

The Enumerator object has no properties.

Methods

atEnd Method | item Method | moveFirst Method | moveNext Method

Requirements

Version 3

See Also

Reference

Boolean Object (JScript 5.6)