DFINDN C-3


NAME



dfindn - find next active record

SYNOPSIS



#include

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.