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