Class FolderIterator

FolderIterator

يشير ذلك المصطلح إلى عنصر يسمح للنصوص البرمجية بالتكرار في مجموعة كبيرة من المجلدات. يمكن الوصول إلى مكرّرات المجلدات من DriveApp، أو File، أو Folder.

// Log the name of every folder in the user's Drive.
var folders = DriveApp.getFolders();
while (folders.hasNext()) {
  var folder = folders.next();
  Logger.log(folder.getName());
}

الطُرق

الطريقةنوع القيمة التي يتم إرجاعهاوصف قصير
getContinuationToken()Stringيحصل على رمز مميز يمكن استخدامه لاستئناف هذا التكرار في وقت لاحق.
hasNext()Booleanتحدِّد هذه السياسة ما إذا كان الاتصال بـ next() سيؤدي إلى عرض عنصر.
next()Folderالحصول على العنصر التالي في مجموعة الملفات أو المجلدات.

الوثائق التفصيلية

getContinuationToken()

يحصل على رمز مميز يمكن استخدامه لاستئناف هذا التكرار في وقت لاحق. هذه الطريقة مفيدة إذا كانت معالجة المكرر في عملية تنفيذ واحدة ستتجاوز الحد الأقصى لوقت التنفيذ. تكون الرموز المميزة للمتابعة عادةً صالحة لمدة أسبوع واحد.

استرجاع الكرة

String: رمز مميّز للاستمرار يمكن استخدامه لاستئناف هذا التكرار مع العناصر التي بقيت في المكرّر عند إنشاء الرمز المميّز


hasNext()

تحدِّد هذه السياسة ما إذا كان الاتصال بـ next() سيؤدي إلى عرض عنصر.

استرجاع الكرة

من Boolean إلى true إذا كان السمة next() ستُرجع سلعة، وfalse إذا لم يتم إرجاعها


next()

الحصول على العنصر التالي في مجموعة الملفات أو المجلدات. ينشئ استثناءً إذا لم تتبق أي عناصر.

استرجاع الكرة

Folder - العنصر التالي في المجموعة