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 - العنصر التالي في المجموعة