fdds_newer - find newer definition, given alias list

SYNOPSIS

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

integer fdds_newer(name, alias)

character*(*) name
character*(*) alias

DESCRIPTION

fdds_newer finds the next newer definition in the "scanned" dictionaries (see fdds_dict). The various fdds_scan... routines (e.g. see fdds_scanf) can then be used to retrieve the definition's value(s). After a call to fdds_dict, fdds_newer will start from the beginning of the dictionary (or first dictionary of several).

INPUT

alias is a list of definition names to search. If the list is empty, then the very next definition is found.

OUTPUT

name will be set to the name of the definition found. If alias is empty, it will be the name of the next definition. If alias contains multiple definitions to search, name will contain the first specific name found. If no definition is found, the return name will be blank. A "0" value is always returned.

EXAMPLES

      character(DEFNNAME_MAX) defn
      character(1000) value
      ...
      ier=fdds_dict(in_dict, 'scan')
      ier=fdds_newer(defn, 'cmd_title cmd_name')
      if (defn.ne.' ') then
      ier=fdds_scanv(' ', value)
      endif
      ...
      ier=fdds_newer(defn, ' ')
      if (defn.ne.' ') write(0,*) 'defn=', defn
      ...

SEE ALSO

fdds_dict Select DDS Dictionary and mode

AUTHOR

Jerry Ehlers, BP America (May 2003)