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