DTFINDI C-3


NAME



dtfindi - find field names in secondary index

SYNOPSIS



#include

struct nd *dtfindi (fp, indexno)
DICT *fp;
int indexno;

DESCRIPTION



An RMSfile may contain secondary indexes that are used to look up
records by fields other than the primary key values. There may be
several secondary indexes for one RMSfile. These secondary
indexes are numbered from 1 to the number of secondary indexes in
the RMSfile. Up to eight data fields can be used in one secondary
index.

Dtfindi returns a pointer to a structure that contains the field
names in the secondary index specified by the indexno parameter.
The value returned is a pointer to a structure that is defined in
the include file .

Fp is the value returned from dtdict(C-3) or dtopen(C-3).

As a special case, if dtfind is called with a indexno value of
zero, dtfindi returns the data field names for the primary key.

SEE ALSO



dtdict(C-3), dtopen(C-3), dtfind(C-3), dtfindk(C-3)
Chapter 4, RMS Programming Guide

DIAGNOSTICS

A value of NULL is returned if the indexno parameter is less than
zero or greater than the number of secondary indexes contained in
the RMSfile or if fp is not an opened RMS dictionary file.

NOTES



The returned value points to static data whose contents are
overwritten with every call.