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