cdds_printt - append definition to dictionary
SYNOPSIS
#include "cdds.h"
int cdds_printt(alias, str);
-
const char *alias
const char *str
[ Description
| Examples
]
DESCRIPTION
cdds_printt 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_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.
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");
/* token values, delimited as needed, i.e. */
/* bar= olive "+ pink" "\=\= ugly" */
j = cdds_printt("bar", "olive");
j = cdds_printt("", "+ pink");
j = cdds_printt("", "== ugly");
j = cdds_printv("", "\n");
SEE ALSO
cdds_dict Select DDS dictionary and mode
cdds_printf Append definition to dictionary
cdds_printv Append definition to dictionary
AUTHOR
R. L. Selzler, EPTG (Oct 1995)