NAME
dfindnk - find next record with same keySYNOPSIS
#includerno_t dfindnk (buffer, fcb) char *buffer; DFILE *fcb; DESCRIPTION
Dfindnk finds the next occurrence of a keyed record in an opened RMSfile. dfindk(C-3) must be called to find the first occurrence of a keyed record. After that call, multiple calls to dfindnk may be made to retrieve successive occurrences of a keyed record. The beginning contents of buffer are ignored by dfindnk. 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), dfindk(C-3), dfindpk(C-3) Chapter 4, RMS Programming Guide DIAGNOSTICS Dfindnk 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.