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

 Syntax


      FT_FGOTO( nLine ) -> NIL

 Arguments


     <nLine> is the record number to go to.

 Returns


     NIL

 Description


     This function moves the record pointer to a specific record
     in the file in the currently selected text file workarea.  If
     the record number requested is greater than the number of records
     in the file, the record pointer will be positioned at the last
     record.

     Internally, the function operates differently depending on how
     you invoke it.  Passing a value for <nLine> results in what
     is effectively a skip operation, which is fairly quick.  However
     if you pass 0 for <nLine>, e.g. ft_fGoTo( 0 ), the function
     internally goes to the top of the file, then skips down the
     required number of records.  Hence if your file is relatively
     large and the current record is a high number, you may see some
     delay as ft_fGoTo(0) skips through the file.

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

 Examples


     // read 5th line of text from file

     ft_fUse( "FTTEXT.C" )

     ft_fGoTo(5)

     cText := ft_fReadLN()


 Source: FTTEXT.C

 Author: Brice de Ganahl and Steve Larsen

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