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>forcerel()</b> http://www.X-Hacker.org [<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 forceRel()
 Force relational seeks
------------------------------------------------------------------------------
 Prototype

     ERRCODE forceRel(
                       WORKAREAP wa
                     )

 Arguments

     wa is a pointer to self.

 Description

     Causes any pending relational seeks for wa to be performed immediately.

 Default Behavior

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

 Implementation Notes

     .  The ideal implementation for forceRel() would have a pending
        relation structure (DBRELINFO) defined as a part of the subclassed
        WORKAREA structure.  Using this information, forceRel() should ensure
        that the workarea buffer is not hot and call SELFRELEVAL() to
        position the workarea.

     .  This is one of the rare instances where wa->found should be
        set if the relational move is successful.  While this is not a
        seek(), part of the specification of the CA-Clipper implementation of
        FOUND() is to return true if a relational seek is successful.

 Files:  Header file is Rdd.api.


See Also: DBRELINFO WORKAREA relEval()

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