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() سيؤدي إلى عرض عنصر.

استرجاع الكرة

من Boolean إلى true إذا كان السمة next() ستُرجع سلعة، وfalse إذا لم يتم إرجاعها


next()

الحصول على العنصر التالي في مجموعة الملفات أو المجلدات. ينشئ استثناءً إذا لم تتبق أي عناصر.

استرجاع الكرة

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