Class FileIterator

FileIterator

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

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

الطُرق

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

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

getContinuationToken()

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

الإرجاع

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

hasNext()

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

الإرجاع

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

next()

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

الإرجاع

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