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