Ein Objekt, das Skripts die Iteration über eine potenziell große Sammlung von Ordnern ermöglicht. Auf Ordner-Iteratoren kann über DriveApp, File oder Folder zugegriffen werden.
// 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());
}
Methoden
| Methode | Rückgabetyp | Kurzbeschreibung |
|---|---|---|
getContinuationToken() | String | Ruft ein Token ab, mit dem diese Iteration zu einem späteren Zeitpunkt fortgesetzt werden kann. |
hasNext() | Boolean | Bestimmt, ob beim Aufrufen von next() ein Element zurückgegeben wird. |
next() | Folder | Ruft das nächste Element in der Datei- oder Ordnersammlung ab. |
Detaillierte Dokumentation
getContinuationToken()
Ruft ein Token ab, mit dem diese Iteration zu einem späteren Zeitpunkt fortgesetzt werden kann. Diese Methode ist nützlich, wenn die Verarbeitung eines Iterators in einer Ausführung die maximale Ausführungszeit überschreiten würde. Fortsetzungs-Tokens sind normalerweise eine Woche lang gültig.
Return
String: Ein Fortsetzungstoken, mit dem diese Iteration mit den Elementen fortgesetzt werden kann, die beim Generieren des Tokens im Iterator verblieben sind
hasNext()
next()
Ruft das nächste Element in der Datei- oder Ordnersammlung ab. Löst eine Ausnahme aus, wenn keine Elemente übrig sind.
Return
Folder – das nächste Element in der Sammlung