אובייקט שמאפשר לסקריפטים לבצע איטרציה באוסף תיקיות גדול שעשוי להיות גדול. תיקייה
אפשר לגשת לאיטרטורים מ-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()
מקבל את הפריט הבא באוסף הקבצים או התיקיות. אם אין פריטים, הפעולה הזו גורמת לחריגה אם אין פריטים יישארו.
חזרה
Folder
– הפריט הבא באוסף