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