[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 skip()
 Reposition cursor relative to current position
------------------------------------------------------------------------------
 Prototype

     ERRCODE skip(
                       AREAP wa,
                       LONG count
                   )

 Arguments

     wa is a pointer to self.

     count is the number of rows to skip.

 Description

     skip() skips count number of rows (count may be negative, indicating
     reverse traversal), obeying filter and scope conditions.  This method is
     intended to provide the functionality of the CA-Clipper SKIP command.

 Default Behavior

     The default implementation of skip() calls skipFilter() and skipRaw() to
     successfully navigate the work area.  skip() also sets wa->fTop,
     wa->fBottom, wa->fBof, and wa->fEof, when appropriate.

     Note:  As implemented, skip() may pass a zero (0) value to skipRaw()
     indicating that a COMMIT (flush()) is to be performed.

 Implementation Notes

     .  If an order is attached to your implementation of work area,
        skip() should support this new ordering as well as any condition or
        filtering behavior.

     .  If your RDD supports relations, update them with a forceRel()
        prior to attempting relative movement.

 Files  Header file is Rdd.api.


See Also: AREA flush() forceRel() go() skipFilter() skipRaw()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson