Fileio.prg
 Binary file manipulation
--------------------------------------------------------------------------------

     FGets( <nHandle>, <nLines>, <nLineLength>, <cDelimiter> ) --> cBuffer

     Read one or more lines from a text file.

     FPuts( <nHandle>, <cString>, <nLength> ) --> nBytes

     Write a line to a text file.

     DirEval( <cMask>, <bAction> ) --> aArray

     Apply a code block to each file matching a skeleton.

     FileTop( <nHandle> ) --> nPos

     Position the file pointer to the first byte in a binary file and return
     the new file position (i.e., 0).

     FileBottom( <nHandle> ) --> nPos

     Position the file pointer to the last byte in a binary file and return
     the new file position.

     FilePos( <nHandle> ) --> nPos

     Report the current position of the file pointer in a binary file.

     FileSize( <nHandle> ) --> nBytes

     Return the size of a binary file.

     FReadLn( <nHandle>, [<nLines>], [<nLineLength>],
        [<cDelimiter>] ) --> cBuffer

     Read one or more lines from a text file.

     FileEval( <nHandle>, [<nLineLength>], [<cDelim>], <bBlock>,
        [<bForCondition>], [<bWhileCondition>],
        [<nNextLines>], [<nLine>], [<lRest>] ) --> NIL

     Apply a code block to lines in a binary file using DBEVAL() as a model.
     If the intent is to modify the file, the output must be written to a
     temporary file and copied over the original when done.

     FEof( <nHandle> ) --> lBoundary

     Determine if the current file pointer position is the last byte in the
     file.

     FWriteLn( <nHandle>, <cString>, <nLength> ) --> nBytes

     Write a line to a text file at the current file pointer position. Check
     FERROR() for the error.