cdds_history - copy an entire history

SYNOPSIS

#include "cdds.h"

int cdds_history();

DESCRIPTION

cdds_history copies all definitions from all scan dictionaries. EOF is returned, if an error is detected, or a print dictionary is not selected. If multiple scan dictionaries are selected, the lowest precedence (older) is copied first, followed by higher (newer) ones. Special history definitions are inserted into the print dictionary. They preserve the name of each scan dictionary, and delimit its contents. For example: 
...old print dictionary contents...
dds_history= scan_dict_name
...contents of scan dictionary...
dds_history_end= scan_dict_name

This routine is not normally used directly by applications, because it is used internally by other DDS routines.

EXAMPLES

int j;

/* copy all scan dictionaries */
j = cdds_history();

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)