seek()
 Position cursor at first row with matching key value
------------------------------------------------------------------------------
 Prototype

     ERRCODE seek(
                       AREAP 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

     seek() 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 work area.  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->fFound 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
        Reference Guide, Volumes 1 and 2 for more information.

 Files  Header file is Rdd.api.