Lettify: Created page with "NOTOC {{BR/Funcao compartilhada}} Força a execução de gravações pendentes no disco. fileWrite não grava diretamente no disco, mas coloca os dados em um buffer temporário; só quando existe dados o suficiente nesse buffer é que as informações são gravadas no disco. Execute essa função se você precisar que os dados sejam gravados no instante em que chamar, sem precisar fechar o arquivo que estiver aberto com as gravações pendentes...."

2023-12-20T18:14:17Z

Created page with "__NOTOC__ {{BR/Funcao compartilhada}} Força a execução de gravações pendentes no disco. fileWrite não grava diretamente no disco, mas coloca os dados em um buffer temporário; só quando existe dados o suficiente nesse buffer é que as informações são gravadas no disco. Execute essa função se você precisar que os dados sejam gravados no instante em que chamar, sem precisar fechar o arquivo que estiver aberto com as gravações pendentes...."

New page

__NOTOC__
{{BR/Funcao compartilhada}}

Força a execução de gravações pendentes no disco. [[PT-BR/fileWrite|fileWrite]] não grava diretamente no disco, mas coloca os dados em um buffer temporário; só quando existe dados o suficiente nesse buffer é que as informações são gravadas no disco. Execute essa função se você precisar que os dados sejam gravados no instante em que chamar, sem precisar fechar o arquivo que estiver aberto com as gravações pendentes. Isso é útil para ''arquivos de log'' que podem querer ler as informações enquanto o resource ainda estiver rodando. [[PT-BR/fileFlush|fileFlush]] pode ser executado depois que cada parte do log for gravada. Sem isso, o arquivo pode parecer vazio ou dessincronizado para o usuário.

==Sintaxe==
<syntaxhighlight lang="lua">
bool fileFlush ( file theFile )
</syntaxhighlight>
{{PT-BR/POO||[[file]]:flush}}

===Argumentos necessários===
*'''theFile:''' O '''arquivo''' que você deseja liberar.

===Retorno===
Retorna '''true''' se as gravações pendentes tiverem sido liberadas com sucesso, '''false''' no caso de falha (ex.: o '''arquivo''' especificado for inválido).

==Exemplo==
<syntaxhighlight lang="lua">
local fileHandle = fileCreate("test.txt")
if fileHandle then
fileWrite(fileHandle, "Line 1")
fileFlush(fileHandle)
-- ... outras operações de escrita
fileClose(fileHandle)
end
</syntaxhighlight>

Tenha em mente que o [[PT-BR/fileClose|fileClose]] automaticamente ''libera'' essas gravações pendentes do disco, do arquivo especificado.

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

PT-BR/fileFlush - Revision history