FATS - Fast Access Tree System Table of Contents List of Commands "AD" Search Next Different After

"AD" Search Next Different After

---

Command string:

CMND$ = "AD\{KeyNo}\{RecNo}\{FileNo}\{KeyString}"

KeyNo	Key number
RecNo	Record number
FileNo	File number
KeyString	Key value

Purpose:

Gets the key value and record number of the data record whose key value is greater and different than the requested key value.

Description:

An FATS index file may contain more than one record with the same key. With this command your application can determine the record corresponding to the first key value which is greater than and different than the key value you specify.
Unlike the command  Search Next After (A), this command skips over duplicate keys.
The key value you specify with "KeyString" don´t have to be a valid key in the index file

Parameters returned:

ERRORCODE:	Errorcode or 0 (no error)
RECNO:	Record number
FATSKEY:	Key value (or KEYADR=address of key)

Example:

CMND$ = "AD\1\"+STR$(RECNO)+"\1\"+KEYSTRING$

See also:

 "ND" Search Next Different; page 4-77

© 2008  GCS Software, Udo Gertz