Class FolderIterator
FolderIterator
אובייקט שמאפשר לסקריפטים לבצע איטרציה על אוסף גדול של תיקיות. אפשר לגשת למערכי החזרה של התיקיות מ-DriveApp, מ-File או מ-Folder.
// Log the name of every folder in the user's Drive.
const folders = DriveApp.getFolders();
while (folders.hasNext()) {
const folder = folders.next();
Logger.log(folder.getName());
}
Methods
| שיטה | סוג הערך המוחזר | תיאור קצר |
getContinuationToken() | String | מקבלת אסימון שאפשר להשתמש בו כדי להמשיך את המחזור הזה במועד מאוחר יותר. |
hasNext() | Boolean | הפונקציה קובעת אם קריאה ל-next() תחזיר פריט. |
next() | Folder | הפונקציה מקבלת את הפריט הבא באוסף הקבצים או התיקיות. |
מסמכים מפורטים
getContinuationToken()
מקבלת אסימון שאפשר להשתמש בו כדי להמשיך את המחזור הזה במועד מאוחר יותר. השיטה הזו שימושית אם עיבוד של מעבד בפעולה אחת יחרוג ממשך ההפעלה המקסימלי.
בדרך כלל, תוקף של אסימוני המשך הוא שבוע אחד.
חזרה
String – טוקן המשך שאפשר להשתמש בו כדי להמשיך את המחזור הזה עם הפריטים שנותרו במעבד הטבלאות כשהטוקן נוצר
hasNext()
הפונקציה קובעת אם קריאה ל-next() תחזיר פריט.
חזרה
Boolean — true אם next() יחזיר פריט, false אם לא
next()
הפונקציה מקבלת את הפריט הבא באוסף הקבצים או התיקיות. אם לא נותרו פריטים, מתרחשת חריגה.
חזרה
Folder — הפריט הבא באוסף
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2024-12-22 (שעון UTC).
[null,null,["עדכון אחרון: 2024-12-22 (שעון UTC)."],[[["`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"]]
