atEnd, méthode

Article
08/21/2008

Mise à jour : novembre 2007

Retourne une valeur booléenne indiquant si l'énumérateur se trouve à la fin de la collection.

function atEnd() : Boolean

Notes

La méthode atEnd retourne la valeur true si l'élément en cours est le dernier de la collection, si la collection est vide ou si l'élément en cours est non défini (undefined). Sinon, elle retourne la valeur false.

Exemple

Dans le code suivant, la méthode atEnd est utilisée pour déterminer si la fin d'une liste de lecteurs a été atteinte :

function ShowDriveList(){
   var fso, s, n, e, x;
   fso = new ActiveXObject("Scripting.FileSystemObject");
   e = new Enumerator(fso.Drives);
   s = "";
   for (; !e.atEnd(); e.moveNext())
   {
      x = e.item();
      s = s + x.DriveLetter;
      s += " - ";
      if (x.DriveType == 3)
         n = x.ShareName;
      else if (x.IsReady)
         n = x.VolumeName;
      else
         n = "[Drive not ready]";
      s +=   n + "<br>";
   }
   return(s);
}