DFINDNI C-3





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



NAME


dfindni - find next record using secondary index

SYNOPSIS


#include 

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

DESCRIPTION


Dfindni reads a record from an RMSfile in secondary key order.
Before calling dfindni, call dseti(C-3) to select the desired
secondary index. dfindi(C-3), dfindfi(C-3), or dsetpos(C-3) can
be called to set the starting point in the secondary index. Each
subsequent call to dfindni returns the next record in secondary
key order. The beginning contents of buffer are ignored by
dfindni.

Dfindni maintains the current position in the secondary index, so
additional records may be fetched in secondary key order by using
the dfindni function repeatedly.

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).

SEE ALSO


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

DIAGNOSTICS

Dfindni returns a value of BAD (-1) if an I/O error occurred, or
if there is no record that contains field values greater than or
equal to the last values returned. If no record is found, then
the contents of buffer are undefined.