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 - مورد بعدی در مجموعه
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-01-14 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-01-14 بهوقت ساعت هماهنگ جهانی."],[[["`FolderIterator` enables scripts to iterate through a large collection of folders within Google Drive."],["It provides methods like `hasNext()` to check for more folders, `next()` to retrieve the next folder, and `getContinuationToken()` for handling lengthy iterations."],["Developers can utilize `FolderIterator` with `DriveApp`, `File`, or `Folder` objects to access and process folders programmatically."]]],["FolderIterator allows iterating over a large collection of folders. Key actions include using `hasNext()` to check for the next item and `next()` to retrieve it. `getContinuationToken()` provides a token to resume iteration later, helpful for large collections. The example shows how to log every folder's name in a user's Drive, demonstrating iteration through the folder collection. The iterator returns folder objects and can throw an exception if no items remain.\n"]]
