Class FolderIterator

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 if next() یک آیتم را برمی گرداند. false اگر نه


next()

مورد بعدی را در مجموعه فایل ها یا پوشه ها دریافت می کند. در صورتی که هیچ موردی باقی نماند یک استثنا می اندازد.

برگشت

Folder - مورد بعدی در مجموعه