Esta página foi traduzida pela API Cloud Translation.

Class FileIterator

Um iterador que permite que os scripts iterem em uma coleção possivelmente grande de arquivos. Arquivo Os iteradores podem ser acessados de DriveApp ou Folder.

// 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());
}

Métodos

Método	Tipo de retorno	Breve descrição
`getContinuationToken()`	`String`	Recebe um token que pode ser usado para retomar essa iteração mais tarde.
`hasNext()`	`Boolean`	Determina se chamar `next()` vai retornar um item.
`next()`	`File`	Acessa o próximo item na coleção de arquivos ou pastas.

Documentação detalhada

`getContinuationToken()`

Recebe um token que pode ser usado para retomar essa iteração mais tarde. Esse método é útil se o processamento de um iterador em uma execução exceder o tempo máximo de execução. Os tokens de continuação geralmente são válidos por uma semana.

Retornar

String: um token de continuação que pode ser usado para retomar essa iteração com os itens que permaneceu no iterador quando o token foi gerado

`hasNext()`

Determina se chamar next() vai retornar um item.

Retornar

Boolean: true se next() retornar um item. false se não for

`next()`

Acessa o próximo item na coleção de arquivos ou pastas. Gera uma exceção quando não há itens permanecem.

Retornar

File: o próximo item na coleção.