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