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

     ERRCODE forceRel(
                          AREAP wa
                        )

 Arguments

     wa is a pointer to self.

 Description

     forceRel() causes any pending relational seeks in the work area
     referenced by 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
        AREA structure.  Using this information, forceRel() should ensure
        that the work area buffer is not hot and call SELF_RELEVAL() to
        position the work area.

     .  This is one of the rare instances when wa->fFound 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: AREA DBRELINFO relEval()

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