Lettify: Created page with "NOTOC {{BR/Funcao compartilhada}} Faz a leitura de uma especificada quantidade de bytes de um determinado arquivo, começando em sua posição atual de leitura/gravação, e retorna o valor como uma ''string''. ==Sintaxe== string fileRead ( file theFile, int count ) {{PT-BR/POO||file:read}} ===Argumentos necessários=== *'''theFile:''' O '''arquivo''' que deseja fazer a leitura. Use fileOpen p..."

2023-12-20T19:37:12Z

Created page with "__NOTOC__ {{BR/Funcao compartilhada}} Faz a leitura de uma especificada quantidade de bytes de um determinado arquivo, começando em sua posição atual de leitura/gravação, e retorna o valor como uma ''string''. ==Sintaxe== <syntaxhighlight lang="lua"> string fileRead ( file theFile, int count ) </syntaxhighlight> {{PT-BR/POO||file:read}} ===Argumentos necessários=== *'''theFile:''' O '''arquivo''' que deseja fazer a leitura. Use fileOpen p..."

New page

__NOTOC__
{{BR/Funcao compartilhada}}

Faz a leitura de uma especificada quantidade de bytes de um determinado arquivo, começando em sua posição atual de leitura/gravação, e retorna o valor como uma ''string''.

==Sintaxe==
<syntaxhighlight lang="lua">
string fileRead ( file theFile, int count )
</syntaxhighlight>

{{PT-BR/POO||[[file]]:read}}

===Argumentos necessários===
*'''theFile:''' O '''arquivo''' que deseja fazer a leitura. Use [[PT-BR/fileOpen|fileOpen]] para obter esse '''arquivo''' mencionado.
*'''count:''' O número de bytes que deseja ler nesse ''arquivo''.

===Retorno===
Returna os bytes que foram lidos, em uma ''string''. Observe que esta ''string'' poderá não conter toda a informação pela quantidade de bytes especificados para a leitura se tiver ocorrido algum erro, ex.: a posição de leitura estiver próximo ou literalmente no fim do arquivo.

==Exemplo==
Este exemplo abre o arquivo "test.txt" e exibe seu conteúdo no console.
<syntaxhighlight lang="lua">
function readFile(path)
local file = fileOpen(path) -- tentamos abrir o arquivo
if not file then
return false -- paramos a função no caso de erro
end
local count = fileGetSize(file) -- obtemos o tamanho total do arquivo
local data = fileRead(file, count) -- fazemos a leitura de todo o arquivo
fileClose(file) -- fechamos o arquivo depois de feito todo o trabalho
outputConsole(data) -- exibimos os dados no console
end

addCommandHandler("readfile",function(cmd,fileName) -- adicionamos o comando para testar a função
readFile(fileName) -- executa a função
end)
</syntaxhighlight>

=== Detalhes relevantes ===
* [[PT-BR/fileOpen|fileOpen]] define a posição de leitura/gravação para o começo do arquivo.
* [[PT-BR/fileGetSize|fileGetSize]] obtém o tamanho total (em bytes) de um determinado arquivo.

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

PT-BR/fileRead - Revision history