PT-BR/fileRead

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

BETA: DA VERSÃO 1.6.0 r21938 ADIANTE

fileGetContents