Click above to get retro games delivered to your door ever month!

SET SOFTSEEK


Syntax:     SET SOFTSEEK on/OFF/(<expL>)

Purpose:    To toggle relative SEEKing on or off.

Usage:      If SOFTSEEK is ON and a match for a SEEK is not found, the
            record pointer is set to the next record in the index with a
            higher key value than the SEEK argument.  If there is no
            record with a higher key value, the record pointer is
            positioned at LASTREC() + 1, EOF() returns true (.T.), and
            FOUND() returns false (.F.).  FOUND() returns true (.T.)
            only if the record is actually found.  It never returns true
            (.T.) for a relative find.

            If SOFTSEEK is OFF and a SEEK is unsuccessful, the record<+>
            pointer is positioned at LASTREC() + 1, EOF() returns true
            (.T.), and FOUND() returns false (.F.).

            Note that SET RELATION ignores SOFTSEEK and so updates the
            record pointer in child work areas as if SOFTSEEK is OFF.

Library:    CLIPPER.LIB


----------------------------------- Example --------------------------------

   SET SOFTSEEK ON
   SEEK "Findit"

   IF FOUND()
      ? "found", RECNO()
   ELSE
      ? "not found"
      ? EOF()
      ? RECNO()
   ENDIF