xHarbour Reference Documentation > Function Reference

HB_FSkip()

Moves the record pointer in the currently selected text file.

Syntax

HB_FSkip( [<nLines>] ) --> NIL

Arguments

<nLines>

This numeric parameter specifies the numbers of lines to move the record pointer in the currently selected text file. Positive values for <nLines> move the record pointer forwards (towards the end of file), negative values move it backwards. The default value is 1, i.e. calling HB_FSkip() with no parameter advances the record pointer to the next text line.

Return

The return value is always NIL.

Description

One record in a text file is one line of text terminated by a Carriage return, Line feed pair. HB_FSkip() moves the record pointer by <nLines> lines. Note, however, that the record pointer cannot be moved outside the range between 1 and HB_FLastRec().

Info

See also:	HB_FEof(), HB_FLastRec(), HB_FGoto(), HB_FReadLN(), HB_FSelect(), HB_FUse()
Category:	File functions , Text file functions , xHarbour extensions
Source:	misc\hb_f.c
LIB:	libmisc.lib