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

Class FolderIterator

يشير ذلك المصطلح إلى كائن يسمح للنصوص البرمجية بالتكرار مع مجموعة كبيرة من المجلدات. مجلد يمكن الوصول إلى المكرّرات من DriveApp أو File أو Folder.

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

الطُرق

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

الوثائق التفصيلية

`getContinuationToken()`

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

الإرجاع

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

`hasNext()`

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

الإرجاع

Boolean — true إذا كانت next() ستعرض سلعة. false إن لم يكن كذلك

`next()`

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

الإرجاع

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