PT-BR/fileIsEOF

From Multi Theft Auto: Wiki
Revision as of 19:04, 20 December 2023 by Lettify (talk | contribs) (Created page with "__NOTOC__ {{BR/Funcao compartilhada}} Verifica se a posição atual no arquivo está no fim dele. {{BR/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== <syntaxhighlight lang="lua"> bool fileIsEOF ( file theFile ) </syntaxhighlight> {{PT-BR/POO||file:isEOF|eof}} ===Argumentos necessários=== *'''theFile:''' O '''arquivo''' que você quer...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

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


Post-it.png 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