cdds_prime - fetch field tag within DDS structures
SYNOPSIS
#include "cdds.h"
FIELD_TAG cdds_prime(bin_tag, field_tag);
-
BIN_TAG bin_tag
FIELD_TAG field_tag
DESCRIPTION
cdds_prime returns the tag associated with the prime type of
the member or object associated with field_tag.
INPUT
bin_tag is the tag associated with an open binary, previously
obtained from cdds_open. It specifies a
particular binary stream.
field_tag is the tag associated with a particular field known
by bin_tag.
OUTPUT
The return value is the field tag associate with the desired object
or -1 if none found.
EXAMPLE
int ndx, rec, *ibuf;
BIN_TAG bin;
FIELD_TAG tag, ptag;
...
/* find index of header, RecNum */
tag = cdds_member(bin, 0, "RecNum");
ndx = cdds_index(bin, tag, DDS_INT);
rec = ibuf[ndx];
...
/* find all trace header tags */
tag = cdds_member(bin, 0, "");
while (tag)
{
ptag = cdds_prime(bin, tag);
...
tag = cdds_next(bin, tag);
}
SEE ALSO
cdds_prec Field precision
cdds_count Field count
cdds_align Field alignment
cdds_genus Field generic type
cdds_name Field name
AUTHOR
Jerry Ehlers, BP America (May 2003)