DFINDLI C-3

NAME

dfindli - find last record in secondary index

Dfindli finds the last record in a secondary index and returns the record in buffer. The beginning values in buffer are ignored by dfindli. Dfindli also saves the current position in the secondary index, and additional records may be fetched in reverse secondary key order by calling dfindpi(C-3).

An RMSfile may have several secondary indexes that are used to retrieve records by other than the primary key value. Before calling dfindli, call dseti(C-3) to select the desired secondary index.

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), dfindpi(C-3), dread(C-3)

Chapter 4,

Dfindli returns a value of BAD (-1) if an I/O error occurred or if the secondary index is empty. If no record is found, the contents of buffer are undefined.