Ein Iterator, der es Skripts ermöglicht, eine potenziell große Sammlung von Dateien zu iterieren. Datei
Iteratoren können über DriveApp
oder Folder
aufgerufen werden.
// 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()); }
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 | Legt fest, ob beim Aufrufen von next() ein Element zurückgegeben wird. |
next() | File | Ruft das nächste Element in der Sammlung von Dateien oder Ordnern 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 bei einer einzelnen Ausführung die maximale Ausführungszeit überschritten würde. Fortsetzungs-Tokens sind in der Regel eine Woche lang gültig.
Rückflug
String
: ein Fortsetzungstoken, mit dem diese Iteration mit den Elementen fortgesetzt werden kann,
im Iterator blieben, als das Token generiert wurde
hasNext()
next()
Ruft das nächste Element in der Sammlung von Dateien oder Ordnern ab. Löst eine Ausnahme aus, wenn keine Elemente vorhanden sind bleiben.
Rückflug
File
– das nächste Element in der Sammlung