cdds_copy - copy one definition
SYNOPSIS
#include "cdds.h"
int cdds_copy(alias);
-
const char * alias
DESCRIPTION
cdds_copy copies one or more definitions from the scan
dictionaries to the print dictionary. The scan and
print dictionaries must have been previously selected by
cdds_dict, or related function. The name of
the definition is specified by alias. Multiple names,
delimited by white space, may be specified by alias. If a name
is specified, the scan dictionaries are searched. See
cdds_scanf and
cdds_printf for a general description of
definition access.
Dictionaries are scanned from bottom-to-top and right-to-left.
The newest definition that matches any alias is selected.
The current scan definition is copied, if a null alias
is specified (i.e. NULL, zero length string, or a string that
only contains white space). The entire value is copied, regardless
of the current position. The function returns the number of
characters in the value copied. EOF is returned, if an error is
detected, a scan definition does not exist, or a print
dictionary is not selected.
This routine is not normally used directly by applications, because
it is used internally by other DDS routines.
EXAMPLES
int j;
/* copy one definition, named "foo" */
j = cdds_copy("foo");
SEE ALSO
cdds_dict Select DDS dictionary and mode
cdds_scan Retrieve value from scan dictionary
cdds_printf Append value to print dictionary
AUTHOR
R. L. Selzler, EPTG (Oct 1995)