[<<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