DFIND C-3


NAME



dfind - find first active record in RMSfile

SYNOPSIS



#include

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

DESCRIPTION



Dfind finds the first active record in an opened RMSfile.

Fcb is the file block pointer returned by dlopen(C-3) or
dopen(C-3).

The record number returned may be saved and used on a subsequent
call to dread(C-3). The record found is returned in buffer.

SEE ALSO



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

DIAGNOSTICS

Dfind returns a value of BAD (-1) if there is no active record or
if an I/O error occurred. If no record is found, the contents of
buffer are undefined.