[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 DBGOBOTTOM()
 Move to the last logical record
------------------------------------------------------------------------------
 Syntax

     DBGOBOTTOM() --> NIL

 Returns

     DBGOBOTTOM() always returns NIL.

 Description

     DBGOBOTTOM() moves to the last logical record in the current work area.

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

 Notes

     .  Logical records: DBGOBOTTOM() operates on logical records.  If
        there is an active index, DBGOBOTTOM() moves to the last record in
        indexed order.  If a filter is set, only records which meet the
        filter condition are considered.

     .  Controlling order: If more than one index is active in the
        work area, the operation is performed using the controlling order as
        set by DBSETORDER() or the SET ORDER command.  For more information,
        refer to the SET ORDER command.

     .  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.
        This function will not affect the locked status of any record.

 Examples

     .  The following example uses DBGOBOTTOM() to position the record
        pointer on the last logical record:

        cLast := "Winston"
        DBUSEAREA( .T., "DBFNTX", "Sales", "Sales", .T. )
        DBSETINDEX( "LASTNAME" )
        //
        Sales->( DBGOBOTTOM() )
        IF ( Sales->Last == "Winston" )
           IF RLOCK()
              Sales->( DBDELETE() )
              ? "Record deleted: ", Sales->( DELETED() )
           ELSE
              ? "Unable to lock record..."
           ENDIF
        END

 Files   Library is CLIPPER.LIB.


See Also: BOF() DBGOTOP() DBSEEK() DBSKIP() EOF() GO
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson