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

N_XSEEKLT()
Find key less than specified value

Syntax
N_XSEEKLT(<Segment1> [, <Segment2> ...])

Argument
See N_XSEEK() for information on specifying key values.

Returns
By definition, N_XSEEKLT can never find an exact match, thus this function 
always returns False.  However it sets N_XEOF() to True if there is no 
record that is less than the specified key;  False if there is any record 
less than the specified key.

Remarks
This and other N_XSEEKxx  functions may be useful to Btrieve programmers 
accustomed to standard Btrieve GET operations. They offer more flexibility 
than the N_XSEEK() function, which attempts to impose a DBFstyle SEEK on a 
Btrieve file. They are particularly useful for complex indexes, where the 
action of N_XSEEK() can be unsatisfactory. See the Btrieve Programmer's 
Manual for additional information on the Less Than operation.

You may use this function in the library or in the RDD.  If you use it in 
the RDD, then it will set FOUND() and EOF() as well as N_XFOUND() and 
N_XEOF().

N_XSEEKGT is not affected by N_XSOFTSEEK.

Example
* Assume an index on Age.
* Retrieve the first record where Age < 35
N_XSEEKLT(35)
IF N_XFOUND()
   * will never get here even if there are
   * records where age = 35
ELSEIF .NOT. N_XEOF()
   * there are records where age < 35
ENDIF