DREAD C-3





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



NAME


dread - read record using record number

SYNOPSIS


#include 

rno_t dread (buf, record, fcb)
char *buf;
rno_t record;
DFILE *fcb;

DESCRIPTION


Dread reads the record stored at the record number specified by
record, where record is between 1 and number of records in the
RMSfile. Record is returned by all calls that access the RMSfile.

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

SEE ALSO


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

DIAGNOSTICS

Dread returns a value of BAD (-1) if record is not within the
range of valid records for the RMSfile, if no record has been
written at the record number specified or if fcb is not an 
opened file block pointer.