[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 FT_FSKIP()
 Move the record pointer to a new position in a text file
------------------------------------------------------------------------------

 Syntax


      FT_FSKIP( [ <nLines> ] ) -> nLinesSkipped

 Arguments


     <nLines> is the number of lines to skip.  Defaults to 1 if
     not specified.

 Returns


     The number of lines actually skipped.  If the file's EOF or
     BOF was encountered before <nLines> could be skipped, the
     return value will be less than <nLines>.

 Description


     This function moves the text file record pointer, similar to
     the CLIPPER SKIP command.

     Use the return value to determine how many records were actually
     skipped, for example to write a custom skipper function for
     TBrowse'g text files.

     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_FRECNO() FT_FGOTOP()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson