fdds_name - fetch field name

SYNOPSIS

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

integer fdds_name(field_name, bin_tag, field_tag)

character(DEFNNAME_MAX) field_name
integer bin_tag
integer field_tag

DESCRIPTION

fdds_name returns the symbolic name associated with the field_tag in the variable, field_name. The returned value is 0 on normal return. A value of -1 is returned on any error.

INPUT

bin_tag is a binary tag, previously obtained from fdds_open. It specifies a particular binary stream.

field_tag is the tag of the field for which the information is desired.

EXAMPLE

      integer   bin, tag, ier
      character*(DEFNNAME_MAX) name
      ...
!     scan first trace header
      tag = fdds_member(bin, 0, ' ')
      ier = fdds_name(name, bin, tag)

SEE ALSO

      fdds_prec Fetch field precision
      fdds_align Fetch field alignment
      fdds_count Fetch field count
      fdds_genus Fetch field genus

AUTHOR

Jerry Ehlers, BP America (May 2003)