[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 FT_FREADLN()
 Read a line from the currently selected text file
------------------------------------------------------------------------------

 Syntax


      FT_FREADLN() -> cLine

 Arguments


     None

 Returns


     A string containing the current record in a text file.

 Description


     This function returns a line of text read from the file in the
     currently selected text file workarea.  Text lines are delimited
     with a CRLF pair.  The record pointer is not moved.

     Currently the maximum record size is 4096 characters.  You may
     increase the maximum record size by changing the value of #define
     BUFFSIZE in the C source and recompiling, however you should
     consider the performance implications if you do (all read and writes
     use this buffer size, including ft_fSkip()'s and ft_fGoto()'s).

     If a read error occurs ft_fError() will contain the error code.

     A text file "record" is a line of text terminated by a CRLF pair.

 Examples


     // display each record of a text file

     FT_FUSE( "text.c" )

     DO WHILE ! FT_FEOF()

        ? FT_FREADLN()

        FT_FSKIP()

     ENDDO


 Source: FTTEXT.C

 Author: Brice de Ganahl and Steve Larsen

See Also: FT_FUSE() FT_FWRITELN() FT_FRECNO() FT_FGOTOP()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson