DFINDLM C-3


NAME



dfindlm - find last matching record using secondary index

SYNOPSIS



#include

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

DESCRIPTION



Dfindlm finds the last record with field values equal to the
beginning field values placed in the data buffer.

An RMSfile may have several secondary indexes associated with it.
These are used to retrieve records by other than the primary key
value. Before calling dfindlm, call dseti(C-3) to select the
desired secondary index. The selected secondary index has between
one and eight fields associated with it. The search values for
these secondary index fields desired must be stored in buffer
before calling dfindlm. If dnumidx(C-3) has been called prior to
this function, only the first n fields of the current index are
compared; otherwise, all fields of the current index are
compared.

Dfindlm returns into the buffer the last record that contains
secondary field values equal to the field values passed in
buffer. Dfindlm also saves the current position in the secondary
index, and additional records that match the field values may be
fetched with the dfindpm(C-3) function. Additionally, records may
be read in reverse secondary key order with the dfindpi(C-3)
function.

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

All character positions in the primary key field are used in
determining the key value. The function strncpy is recommended
for storing string key values in buffer.

SEE ALSO



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

DIAGNOSTICS

Dfindlm returns a value of BAD (-1) if an I/O error occurred or
if there is no record that contains field values equal to the
beginning values passed in buffer. If no record is found, the
contents of buffer are undefined.