Click above to get retro games delivered to your door ever month!

 File GET Logical Record.
------------------------------------------------------------------------------

 Syntax

         GT_FGetLR(<fp>, [<cCont>]) --> cBuff

 Arguments:

       <fp>          - file pointer
       <cCont>       - continuation character (will default to \ the
                       standard C (and UNIX) continuity character)

 Returns:

       cBuff         - Line of text excluding cont. characters and
                       any CHR(13)+CHR(10) pairs

 Description:

       Reads the next logical record from stream 'fp' into a
       buffer until next unescaped newline, end of file or read
       error.
       A logical record may span several physical records (lines)
       by having each newline escaped with the standard C escape
       character (for those who don't know it is the \).  This
       character may be overridden by any other character eg. a
       semi-colon if you are trying to read clipper source.

 Examples:

       See Test Harness in source.
       compile with -DTESt
  $CAVEATS$
       Poor error handling for files, will return what has been
       read up until the file error.

       Assumes that CHR(13) does not occur by itself and is always
       paired with a CHR(10)

 Source: FGETLR.PRG

 Author:  Andy M Leighton