Class FileIterator

FileIterator

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

MethodeRückgabetypKurzbeschreibung
getContinuationToken()StringRuft ein Token ab, mit dem diese Iteration zu einem späteren Zeitpunkt fortgesetzt werden kann.
hasNext()BooleanBestimmt, ob beim Aufrufen von next() ein Element zurückgegeben wird.
next()FileRuft 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()

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

Return

Boolean: true, wenn next() einen Artikel zurückgibt; false, wenn nicht


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