تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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