FREADSTR()
 Read characters from a binary file
------------------------------------------------------------------------------
 Syntax

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

 Arguments

     <nHandle> is the file handle obtained from FOPEN(), FCREATE(), or
     predefined by DOS.

     <nBytes> is the number of bytes to read, beginning at the current
     DOS file pointer position.

 Returns

     FREADSTR() returns a character string up to 65,535 (64K) bytes.  A null
     return value ("") indicates an error or end of file.

 Description

     FREADSTR() is a low-level file function that reads characters from an
     open binary file beginning with the current DOS file pointer position.
     Characters are read up to <nBytes> or until a null character (CHR(0)) is
     encountered.  All characters are read including control characters
     except for CHR(0).  The file pointer is then moved forward <nBytes>.  If
     <nBytes> is greater than the number of bytes from the pointer position
     to the end of the file, the file pointer is positioned to the last byte
     in the file.

     Warning!  This function allows low-level access to DOS files and
     devices.  It should be used with extreme care and requires a thorough
     knowledge of the operating system.

 Examples

     .  This example displays the ASCII values of the first 16 bytes
        of a text file:

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

 Files   Library is CLIPPER.LIB.

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