fdds_prime - fetch field prime type tag

SYNOPSIS

#include <fdds.h> (fixed-format sources)
#include <f90dds.h> (free-format sources)

integer fdds_prime(bin_tag, field_tag)

integer bin_tag
integer field_tag

DESCRIPTION

fdds_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 fdds_open. It specifies a particular binary stream.

field_tag is the tag associated with a particular field known by bin_tag. A value of "0" always refers to the entire trace field.

OUTPUT

The return value is the field tag associate with the desired object or -1 if none found.

EXAMPLE

      integer bin, tag, ptag
      ...
!     find all trace header tags  
      tag=fdds_member(bin,0,' ')
      do while (tag)
         ptag=fdds_prime(bin,tag)
         ...
         tag=fdds_next(bin,tag)
      enddo

SEE ALSO

fdds_member  Fetch field tag
fdds_object  Fetch object tag
fdds_next Fetch next field tag
fdds_prev Fetch previous field tag
fdds_parent Fetch parent field tag

AUTHOR

Jerry Ehlers, BP America (May 2003)