fdds_printv - append definition to DDS dictionary

SYNOPSIS

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

integer function fdds_printv(alias, str)

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

DESCRIPTION

fdds_printv 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. The values are definition names, delimited by white space.

fdds_printv uses a string referenced by str. It is taken literally, without special interpretation. The string is appended to the existing value, if any. This call is somewhat unique to the other Fortran print calls in that all trailing white space in the string is used.

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 an array of float values
      ier = fdds_printv('omega', ' zeta ZETA Zeta\n')

SEE ALSO

fdds_printf Append a definition
fdds_printt Append a definition

AUTHOR

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