DFINDN C-3





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



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.