DBGOTO()
 Move to the record having the specified record number
------------------------------------------------------------------------------
 Syntax

     DBGOTO(<nRecordNumber>) --> NIL

 Arguments

     <nRecordNumber> is a numeric value that specifies the record number
     of the desired record.

 Returns

     DBGOTO() always returns NIL.

 Description

     DBGOTO() moves to the record whose record number is equal to
     <nRecordNumber>.  If no such record exists, the work area is positioned
     to LASTREC() + 1 and both EOF() and BOF() return true (.T.).

     DBGOTO() performs the same function as the standard GO command.  For
     more information, refer to the GO command.

 Notes

     .  Logical records: DBGOTO() does not respect logical visibility.
        That is, if the specified record exists, it will become the current
        record regardless of any index or filter condition.

     .  Network environment: For a shared file on a network, moving to
        a different record may cause updates to the current record to become
        visible to other processes.  For more information, refer to the
        Network Programming chapter in the Programming and Utilities guide.

 Examples

     .  The following example uses DBGOTO() to iteratively process
        every fourth record:

        DBUSEAREA( .T., "DBFNTX", "Sales", "Sales", .T. )
        //
        // toggle every fourth record
        DO WHILE !EOF()
           DBGOTO( RECNO() + 4 )
           Sales->Group := "Bear"
        ENDDO

 Files:  Library is CLIPPER.LIB.