Class FileIterator

Fileiterator

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

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

الطُرق

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

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

getContinuationToken()

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

تذكرة ذهاب وعودة

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


hasNext()

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

تذكرة ذهاب وعودة

Booleantrue إذا كانت next() ستعيد عنصرًا، false إذا لم يتم إرجاعها


next()

الحصول على العنصر التالي في مجموعة الملفات أو المجلدات. تطبيق استثناء في حال عدم وجود أي عناصر.

تذكرة ذهاب وعودة

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