HB_FGoTop

Move the record pointer to the first record in selected text file

Syntax

      HB_FGoTop() -> NIL

Argument

None

Returns

NIL

Description

HB_FGoTop() moves the record pointer to the first record in the currently selected text file workarea.

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

Example

      HB_FUse( "test.txt" )    // open text file to the selected work area
      WHILE !HB_FEOF()
         ? HB_FReadLn()        // read a record / line
         HB_FSkip()            // Go to next record / line
      ENDDO
      HB_FGoTop()              // go to top of file ( first record / line )
      ? HB_FRecNo()            // 1

Seealso

HB_FAtEOF(), HB_FEof(), HB_FGoBottom(), HB_FGoto(), HB_FInfo(), HB_FLastRec(), HB_FReadAndSkip(), HB_FreadLN(), HB_FRecno(), HB_FSelect(), HB_FSkip(), HB_FUse()