NAME
dfindn - find next active record
SYNOPSIS
#include <cbase/dirio.h>
rno_t dfindn (buffer, fcb)
char *buffer;
DFILE *fcb;
DESCRIPTION
Dfindn returns the next active record from an opened RMSfile. The order of the keys returned by successive calls to dfindn 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).
The returned record number may be saved and used on a subsequent call to dread(C-3). An RMSfile can be read sequentially by calling dfind(C-3) followed by successive calls to dfindn.
SEE ALSO
dlopen(C-3), dopen(C-3), dfind(C-3), dread(C-3)
Chapter 4,
RMS Programming Guide
DIAGNOSTICS
Dfindn 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.