DFINDLI C-3


NAME



dfindli - find last record in secondary index

SYNOPSIS



#include

rno_t dfindli (buffer, fcb)
char *buffer;
DFILE *fcb;

DESCRIPTION



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).

SEE ALSO



dlopen(C-3), dopen(C-3), dseti(C-3), dfindpi(C-3), dread(C-3)
Chapter 4, RMS Programming Guide

DIAGNOSTICS



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.