Ein Iterator, der Skripts die Iteration über eine potenziell große Sammlung von Dateien ermöglicht. Auf Datei-Iteratoren kann über DriveApp
oder eine Folder
zugegriffen 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 | Bestimmt, ob beim Aufrufen von next() ein Element zurückgegeben wird. |
next() | File | 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
File
– das nächste Element in der Sammlung