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>seek()</b> http://www.X-Hacker.org [<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 seek()
 Position cursor at first row with matching key value
------------------------------------------------------------------------------
 Prototype

     ERRCODE seek(
                   WORKAREAP wa,
                   BOOL isSoft,
                   ITEM keyVal
                 )

 Arguments

     wa is a pointer to self.

     isSoft is set when a softseek is to be performed.

     keyVal is the search value.

 Description

     Positions the cursor for wa to the row whose key value matches keyVal.

 Default Behavior

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

 Implementation Notes

     .  The definition of seek() assumes that an Order has been
        imposed on the workarea.  You must match keyVal against the key value
        of this ordering.

     .  Once the seek() has been performed, your implementation of
        seek() should set the wa->found flag, if possible.  If you cannot set
        this flag at the time of the seek(), you should investigate
        subclassing the found() method to tailor it to your specific needs.

     .  When the CA-Clipper SOFTSEEK-style SEEK is required, the
        boolean value isSoft should be TRUE.  See SET SOFTSEEK in your
        CA-Clipper Reference guide for more information.

 Files:  Header file is Rdd.api.


See Also: WORKAREA found()

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