DFINDK C-3





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



NAME


dfindk - find record with given primary key

SYNOPSIS


#include 

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

DESCRIPTION


Dfindk finds the first occurrence of a keyed record in an opened
RMSfile. The primary key for the record desired must be stored in
buffer before calling dfindk.

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.  All 
character positions allocated to the primary key field are used
in determining the key value. The function strncpy is recommended
for storing string key values in buffer.

SEE ALSO


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

DIAGNOSTICS

Dfindk 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, the
contents of buffer are undefined.