[<<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()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson