Lettify: 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== bool fileIsEOF ( file theFile ) {{PT-BR/POO||file:isEOF|eof}} ===Argumentos necessários=== *'''theFile:''' O '''arquivo''' que você quer..."

2023-12-20T19:04:03Z

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..."

New page

__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 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.
<syntaxhighlight lang="lua">
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
</syntaxhighlight>

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

==Veja também==
{{PT-BR/File functions}}

PT-BR/fileIsEOF - Revision history