PT-BR/fileIsEOF

Verifica se a posição atual no arquivo está no fim dele.

	Nota: Devido às restrições subjacentes da API C, esta função pode retornar false até que seja feita uma tentativa de leitura além do final do arquivo.

Sintaxe

bool fileIsEOF ( file theFile )

Sintaxe POO(OOP) Não entendeu o que significa isso?

Método: file:isEOF(...)

Variável: .eof

Argumentos necessários

theFile: O arquivo que você quer verificar.

Retorno

Retorna true se a posição do arquivo especificado está no final do mesmo, false caso contrário.

Exemplo

This example opens the file test.txt and outputs its contents to the console.

local hFile = fileOpen("test.txt", true)       -- tentamos abrir o arquivo (em modo leitura)
if hFile then                                  -- verificamos se foi aberto com sucesso
    local buffer
    while not fileIsEOF(hFile) do              -- desde que não estejamos no fim do arquivo...
        buffer = fileRead(hFile, 500)          -- ... lemos os próximos 500 bytes ...
        outputConsole(buffer)                  -- ... e exibimos no console.
    end
    fileClose(hFile)                           -- fechamos o arquivo depois que terminarmos com ele
else
    outputConsole("Unable to open test.txt")
end

Quando você abre um arquivo, a posição do cursor de leitura/gravação é definida para o início do arquivo. Cada chamada para fileRead ou fileWrite avança essa posição para a quantidade de bytes que forem lidos/gravados. Esta forma, usando fileIsEOF você pode verificar se você passou por todo o arquivo durante essas execuções.

Veja também

BETA: DA VERSÃO 1.6.0 r21938 ADIANTE

fileGetContents