cdds_printv - append definition to dictionary
SYNOPSIS
#include "cdds.h"
int cdds_printv(alias, str);
-
const char *alias
const char *str
[ Description
| Examples
]
DESCRIPTION
cdds_printv appends a definition to a dictionary. The
print dictionary must have been previously selected by
cdds_dict, or related function.
The name of the definition is specified by alias.
If a null alias is specified (i.e. NULL, zero length
string, or a string that only contains white space) then the value
is appended to the current print definition.
cdds_printv uses a string referenced by str.
It is taken literally, without special interpretation.
The string is appended to the existing value, if any.
The function returns the number of characters in the string.
EOF is returned, if an error is detected or a print definition
does not exist.
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.
See cdds_scanf for a description of
alias definitions.
EXAMPLES
int j;
j = cdds_printv("foo", " red green blue\n");
j = cdds_printv("scale", "95%\n");
SEE ALSO
cdds_dict Select DDS dictionary and mode
cdds_printf Append definition to dictionary
cdds_printt Append definition to dictionary
AUTHOR
R. L. Selzler, EPTG (Oct 1995)