Class FolderIterator

FolderIterator

كائن يتيح للبرامج النصية تكرار مجموعة كبيرة محتملة من المجلدات. يمكن الوصول إلى أدوات تكرار المجلدات من DriveApp أو File أو Folder. 

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

الطُرق

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

مستندات تفصيلية

getContinuationToken()

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

الإرجاع

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

hasNext()

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

الإرجاع

‫Boolean — true إذا كانت الدالة next() تعرض عنصرًا، أو false إذا لم تعرض عنصرًا

next()

تعرض هذه السمة العنصر التالي في مجموعة الملفات أو المجلدات. يطرح هذا الإجراء استثناءً إذا لم تبقَ أي عناصر.

الإرجاع

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