איטרטור שמאפשר לסקריפטים לבצע איטרציה על פני אוסף קבצים שעשוי להיות גדול. קובץ
אפשר לגשת לאיטרטורים דרך DriveApp
או Folder
.
// Log the name of every file in the user's Drive. var files = DriveApp.getFiles(); while (files.hasNext()) { var file = files.next(); Logger.log(file.getName()); }
שיטות
שיטה | סוג הערך המוחזר | תיאור קצר |
---|---|---|
getContinuationToken() | String | הוא מקבל אסימון שיכול לשמש כדי להמשיך את האיטרציה הזו במועד מאוחר יותר. |
hasNext() | Boolean | המדיניות הזו קובעת אם שיחה אל next() תחזיר פריט. |
next() | File | מקבל את הפריט הבא באוסף הקבצים או התיקיות. |
מסמכי תיעוד מפורטים
getContinuationToken()
הוא מקבל אסימון שיכול לשמש כדי להמשיך את האיטרציה הזו במועד מאוחר יותר. השיטה הזו מועילה אם עיבוד איטרטור בביצוע אחד יגרום לחריגה מזמן הביצוע המקסימלי. אסימוני המשך תקפים בדרך כלל לשבוע אחד.
חזרה
String
- אסימון המשך שניתן להשתמש בו כדי להמשיך את האיטרציה עם הפריטים
נשאר באיטרטור כשהאסימון נוצר
hasNext()
next()
מקבל את הפריט הבא באוסף הקבצים או התיקיות. אם אין פריטים, הפעולה הזו גורמת לחריגה אם אין פריטים יישארו.
חזרה
File
– הפריט הבא באוסף