DFINDPK C-3





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



NAME


dfindpk - find previous record with same key

SYNOPSIS


#include 

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

DESCRIPTION


Dfindpk finds the previous occurrence of a keyed record in an
opened RMSfile. dfindlk(C-3) must be called to find the last
occurrence of a keyed record. After that call, multiple calls to
dfindpk may be made to retrieve previous occurrences of a keyed
record. The beginning contents of buffer are ignored by dfindpk.

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). The record found is returned in buffer.

SEE ALSO


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

DIAGNOSTICS

Dfindpk returns a value of BAD (-1) if the record is not found or
if an I/O error occurred. If the record is not found then the
contents of buffer are undefined.