Class FileIterator

FileIterator

Ein Iterator, mit dem in Skripts eine potenziell große Sammlung von Dateien durchlaufen werden kann. Auf Datei-Iteratoren kann über DriveApp oder einen Folder zugegriffen werden.

// Log the name of every file in the user's Drive.
const files = DriveApp.getFiles();
while (files.hasNext()) {
  const file = files.next();
  Logger.log(file.getName());
}

Methoden

MethodeRückgabetypKurzbeschreibung
getContinuationToken()StringRuft ein Token ab, das verwendet werden kann, um diese Iteration zu einem späteren Zeitpunkt fortzusetzen.
hasNext()BooleanLegt fest, ob beim Aufrufen von next() ein Element zurückgegeben wird.
next()FileRuft das nächste Element in der Sammlung von Dateien oder Ordnern ab.

Detaillierte Dokumentation

getContinuationToken()

Ruft ein Token ab, das verwendet werden kann, um diese Iteration zu einem späteren Zeitpunkt fortzusetzen. Diese Methode ist nützlich, wenn die Verarbeitung eines Iterators in einer Ausführung die maximale Ausführungszeit überschreitet. Fortsetzungstokens sind in der Regel eine Woche lang gültig.

Rückflug

String: Ein Fortsetzungstoken, mit dem diese Iteration mit den Elementen fortgesetzt werden kann, die beim Generieren des Tokens im Iterator verblieben sind.


hasNext()

Legt fest, ob beim Aufrufen von next() ein Element zurückgegeben wird.

Rückflug

Boolean – true, wenn next() ein Element zurückgibt, andernfalls false.


next()

Ruft das nächste Element in der Sammlung von Dateien oder Ordnern ab. Löst eine Ausnahme aus, wenn keine Elemente mehr vorhanden sind.

Rückflug

File: Das nächste Element in der Sammlung.