dfindni - find next record using secondary index
#include
rno_t dfindni (buffer, fcb)
char *buffer;
DFILE *fcb;
Dfindni reads a record from an RMSfile in secondary key order.
Before calling dfindni, call dseti(C-3)
to select the desired
secondary index. dfindi(C-3), dfindfi(C-3),
or dsetpos(C-3) can
be called to set the starting point in the secondary index. Each
subsequent call to dfindni returns the next record in secondary
key order. The beginning contents of buffer are ignored by
dfindni.
Dfindni maintains the current position in the secondary index, so
additional records may be fetched in secondary key order by using
the dfindni function repeatedly.
Fcb is the file block pointer returned by dlopen(C-3)
or
dopen(C-3).
The returned record number may be saved and used on a subsequent
call to dread(C-3).
dlopen(C-3), dopen(C-3),
dseti(C-3), dfindfi(C-3),
dfindi(C-3)
Chapter 4, RMS Programming Guide
Dfindni returns a value of BAD (-1) if an I/O error occurred, or
if there is no record that contains field values greater than or
equal to the last values returned. If no record is found, then
the contents of buffer are undefined.