fileRead

Lê bytes a partir da posição atual.

Sintaxe

string fileRead ( file oArquivo, number quantidade )

Parâmetros

Nome	Tipo	Padrão	Descrição
oArquivo	file	—	Handle aberto.
quantidade	number	—	Quantos bytes ler.

A leitura avança a posição pela quantidade de bytes efetivamente lidos. Perto do fim do arquivo você recebe menos bytes do que pediu, e no fim recebe uma string vazia. A leitura é binária: bytes \0 são preservados.

Retorno

A string lida, ou nil se o handle for inválido ou a quantidade for negativa.

Exemplo

local arquivo = fileOpen("dados/save.bin", true)
local cabecalho = fileRead(arquivo, 4)
fileClose(arquivo)

Veja também

• fileOpen — Abre um arquivo existente.
• fileCreate — Cria um arquivo novo, ou zera um que já exista.
• fileClose — Grava as alterações pendentes no disco e fecha o arquivo.
• fileFlush — Grava no disco o que foi escrito até agora, sem fechar o arquivo.
• fileWrite — Escreve uma ou mais strings a partir da posição atual.
• fileGetContents — Devolve o conteúdo inteiro do arquivo.
• fileGetSize — Devolve o tamanho do arquivo em bytes.
• fileGetPos — Devolve a posição atual de leitura e escrita.