PT-BR/fileRead

From Multi Theft Auto: Wiki
Revision as of 19:37, 20 December 2023 by Lettify (talk | contribs) (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...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

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 )

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

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

Argumentos necessários

  • theFile: O arquivo que deseja fazer a leitura. Use 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.

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)

Detalhes relevantes

  • fileOpen define a posição de leitura/gravação para o começo do arquivo.
  • fileGetSize obtém o tamanho total (em bytes) de um determinado arquivo.

Veja também