Enumerator.atEnd

Non-standard. Do not use!
This object is a Microsoft extension and is only supported in Internet Explorer.

The Enumerator.atEnd method returns a Boolean value indicating if the enumerator is at the end of the collection.

Syntax

myEnum.atEnd() 

Remarks

The required myEnum reference is any Enumerator object.

The atEnd method returns true if the current item is the last one in the collection, the collection is empty, or the current item is undefined. Otherwise, it returns false.

Example

In following code, the atEnd method is used to determine if the end of a list of drives has been reached:

function ShowDrives()  
{  
    var s = "";  
    var bytesPerGB = 1024 * 1024 * 1024;  

    var fso = new ActiveXObject("Scripting.FileSystemObject");  
    var e = new Enumerator(fso.Drives);  

    e.moveFirst();  
    while (e.atEnd() == false)  
    {  
        var drv = e.item();  

        s += drv.Path + " - ";  

        if (drv.IsReady)  
        {  
            var freeGB = drv.FreeSpace / bytesPerGB;  
            var totalGB = drv.TotalSize / bytesPerGB;  

            s += freeGB.toFixed(3) + " GB free of ";  
            s += totalGB.toFixed(3) + " GB";  
        }  
        else  
        {  
            s += "Not Ready";  
        }  

        s += "<br />";  

        e.moveNext();  
    }  
    return(s);  
}

Requirements

Supported in the following document modes: Quirks, Internet Explorer 6 standards, Internet Explorer 7 standards, Internet Explorer 8 standards, Internet Explorer 9 standards, and Internet Explorer 10 standards. Not supported in Windows 8.x Store apps.

Applies ToEnumerator Object

See also

Document Tags and Contributors

Contributors to this page: ExE-Boss, khorne3, erikadoyle
Last updated by: ExE-Boss,