FREADSTR()
 Lê caracteres de um arquivo binário
------------------------------------------------------------------------------

 Sintaxe

     FREADSTR(<nHandle>, <nBytes>) --> cString

 Argumentos

     <nHandle> é o handle do arquivo obtido da funçao FOPEN() ou
     FCREATE(), ou que tenha sido pré-definido pelo DOS.

     <nBytes> é a quantidade de bytes a serem lidos a partir da posiçao
     corrente do ponteiro de arquivos do DOS.

 Retorno

     FREADSTR() retorna uma cadeia de caracteres de até 65.535 (64K) bytes.
     Um valor de retorno nulo ("") indica um erro ou final de arquivo.

 Descriçao

     FREADSTR() é uma funçao de tratamento de arquivos de baixo nível que lê
     os caracteres de um arquivo binário a partir da posiçao corrente do
     ponteiro de arquivos do DOS.  Os caracteres sao lidos até que se atinja
     <nBytes> ou até que seja encontrado um caractere nulo (CHR(0)).  Todos
     os caracteres sao lidos (inclusive caracteres de controle) exceto os
     caracteres nulos CHR(0).  O ponteiro de arquivos depois move-se até
     chegar em <nBytes>.  Caso <nBytes> seja maior do que a quantidade de
     bytes existente entre a posiçao do ponteiro e o final do arquivo, o
     ponteiro de arquivos fica posicionado no último byte do arquivo.

     -----------------------------------------------------------------------
     . Aviso

     Esta funçao permite acesso de baixo nível a arquivos e dispositivos do
     DOS.  Ela deve ser utilizada com extremo cuidado, e exige que se
     conheça a fundo o sistema operacional.
     -----------------------------------------------------------------------

 Exemplos

     O exemplo a seguir exibe os códigos ASCII dos 16 primeiros bytes de um
     arquivo texto:

     #include "Fileio.ch"
     //
     nHandle = FOPEN("New.txt", FC_NORMAL)
     IF FERROR() != 0
        ? "Erro de abertura:" FERROR()
        BREAK
     ELSE
        cString = FREADSTR(nHandle, 16)
        ? cString
        FCLOSE(nHandle)
     ENDIF

 Arquivos:  Biblioteca CLIPPER.LIB.
 To download this example - click here.

See Also: BIN2I() BIN2L() BIN2W() FERROR() FREAD() FSEEK()