Lê caracteres binários de um arquivo.
Sintaxe
FREAD( nHandle , @cBuffer , nQtdBytes ) –> Numérico
Descrição
FREAD() lê a partir um arquivo aberto, através de FCLOSE(), FCREATE(), FOPENPORT(), os dados e armazena no buffer informado. FREAD() lê normalmente caracteres de controle (ASC 128, ASC 0, etc.).
FREAD() lerá até o número de bytes informado em nQtdBytes; caso aconteça algum erro ou o arquivo chegue ao final, FREAD() retornará um número menor que o nQtdBytes.
O buffer passado para leitura deve ser sempre pré-alocado e passado como referência. Caso contrário, os dados não poderão ser retornados.
FREAD() lê a partir da posição atual do ponteiro, que pode ser ajustado pelo FSEEK() ou por FWRITE(), FREADSTR().
Exemplos
Este exemplo lê 128 bytes em um buffer.
#define F_BLOCK 128
//
cBuffer := SPACE(F_BLOCK)
nHandle := FOPEN(“Temp.txt”)
//
IF FERROR() != 0
? “Abertura de arquivos com erro: “, FERROR()
ELSE
IF FREAD(nHandle, @cBuffer, F_BLOCK) <> F_BLOCK
? “Erro lendo arquivo”
ENDIF
FCLOSE(nHandle)
ENDIF