dfindk - find record with given primary key
rno_t dfindk (buffer, fcb)
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.
dlopen(C-3), dopen(C-3), dread(C-3), strncpy(C-3)
RMS Programming Guide
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.