Retro video games delivered to your door every month!
Click above to get retro games delivered to your door ever month!
X-Hacker.org- CA-Clipper 5.2 . Technical Reference - <b>goto()</b> http://www.X-Hacker.org [<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 goTo()
 Position cursor at a specific physical identity (record)
------------------------------------------------------------------------------
 Prototype

     ERRCODE goTo(
                   WORKAREAP wa,
                   ULONG row
                 )

 Arguments

     wa is a pointer to self.

     row is the row number of the new cursor position.

 Description

     Repositions the workarea 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 goTo() 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 goTo() 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 that fact as an incompatibility of your driver with
        the high-level CA-Clipper syntax.

 Files:  Header file is Rdd.api.


See Also: WORKAREA goBottom() goTop()

Online resources provided by: http://www.X-Hacker.org --- NG 2 HTML conversion by Dave Pearson