fdds_printt - append definition to DDS dictionary

SYNOPSIS

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

integer function fdds_printt(alias, str)

character*(*) alias
character*(*) str

DESCRIPTION

fdds_printt appends a definition to a dictionary. The print dictionary must have been previously selected by fdds_dict, or related function. The name of the definition is specified by alias.

One definition name may be specified by alias. If specified, a new definition is appended to the print dictionary. A new definition is not created, if a blank alias is specified. In this case the value is appended to the current print definition.

If the alias definition name is prefixed with "alias:" or "?", a definition alias is appended to the dictionary.

fdds_printt uses a string referenced by str. A token is created and appended to the existing value, if any. The token is delimited by blanks and double quotes as needed. Quotes are used only if the string is zero length, contains white space, or has special characters ('\', '=', '"'). Escape characters '\' are automatically inserted, to preserve special characters like ".

INPUT

alias identifies a new definition, or continued processing of the value for the current one.

OUTPUT

The contents of the current output dictionary may be changed.

No function is provided to over write existing definitions -- history can't be changed. An existing name can be appended again, which effectively redefines its value.

The return value is the number of characters written, or negative (EOF) if an error occurred. Zero is returned, if an output dictionaries is not open.

EXAMPLES

!     append "beta" definition to output dictionary
      ier = fdds_printt('beta', 'this is a value\n')

!     append an alias to undefine "gamma"
      ier = fdds_printt($gamma',' \n')

SEE ALSO

fdds_printf Append a definition
fdds_printv Append a definition

AUTHOR

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