[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 go()
 Position cursor at a specific physical identity (record)
------------------------------------------------------------------------------
 Prototype

     ERRCODE go(
                       AREAP wa,
                       ULONG row
                   )

 Arguments

     wa is a pointer to self.

     row is the row number of the new cursor position.

 Description

     go() repositions the work area cursor for wa to the physical row number row.

 Default Behavior

     You must implement the default behavior of this method through a
     subclass.

 Implementation Notes

     .  Since go() repositions the pointer to a physical row number,
        you need not consider active scopes or filters.  If the row is not in
        the physical range of rows available, you may generate an error or
        position the pointer at the physical end of file.

     .  In CA-Clipper, the idea of a phantom row is vital to the
        performance of certain functions.  The go() method should permit
        access to the phantom row.  The phantom row is defined as the last
        row + 1 and is the position at which end of file is set to TRUE.  All
        columns of the phantom row are empty.  A row value greater than the
        last row in the table should position the pointer to the phantom row.
        If you do not support the concept of the phantom row in your driver,
        you must document this fact as an incompatibility of your driver with
        the high-level CA-Clipper syntax.

 Files  Header file is Rdd.api.


See Also: AREA goBottom() goTop()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson