DFINDP C-3





Copyright (C) 1994-95 Conetic Software Systems, Inc. All names, products, and services mentioned are the trademarks of their respective organizations.



NAME


dfindp - find previous active record

SYNOPSIS


#include 

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

DESCRIPTION


Dfindp finds the previous active record in an RMSfile and returns
it in buffer. The order of the keys returned by successive calls
to dfindp is undefined. Each record returned is one that has been
added to the RMSfile but not deleted.

Fcb is the file block pointer returned by dlopen(C-3) or
dopen(C-3). Buffer is assumed to be large enough to hold the
record.

The returned record number may be saved and used on a subsequent
call to dread(C-3). An RMSfile can be read sequentially in
reverse order by calling dfindl(C-3) followed by successive calls
to dfindp. Calls to dfindn(C-3) are allowed before or after a
call to dfindp(C-3).

SEE ALSO


dlopen(C-3), dopen(C-3), dfindl(C-3), dfindn(C-3), dread(C-3)
Chapter 4, RMS Programming Guide

DIAGNOSTICS

Dfindp returns a value of BAD (-1) if the last active record in
the RMSfile has already been read or if an I/O error occurred.