fdds_out - initialize a DDS dictionary for output

SYNOPSIS

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

integer function fdds_out(dict, alias, value, hist)

character*(*) dict
character*(*) alias
character*(*) value
character*(*) hist

[ Description | Input | Output | Examples ]

DESCRIPTION

fdds_out initializes dictionaries for output data. End users may define the dictionary name via alias. Programmers may provide a default dictionary name via value. If alias and value fail to yield a name, a temporary dictionary is created and a warning is issued. The hist dictionary contents are copied to the output dictionary.

INPUT

The bootstrap dictionaries (par:) are searched for alias definitions and then are copied to the dictionary that is opened for output.

alias is a list of definition names, delimited by white space. If a name is specified, the bootstrap dictionaries are searched. If a definition is found, its value specifies a dictionary name. This name is returned by the function.

Value provides a default name for the dictionary. It is used if a name can't be retrieved via alias.

hist provides a dictionary name. If specified, the dictionary should contain the processing history. It is used to initialize the output dictionary.

OUTPUT

The function returns the opened dictionary name in the dict parameter. The function returns the name of the resulting dictionaries.

The dictionary returned by fdds_out is opened in "print" mode. Modes are described in fdds_dict.

EXAMPLES

      integer j
      character*1024 in, out
      ...
!     open output dictionary
      j = fdds_out(out, 'out', 'stdout:', in)
      ...

SEE ALSO

fdds_dict
fdds_in
fdds_mod

AUTHOR

R. L. Selzler, EPTG (May, 1994)