DtPrintCopySetupData(library call) DtPrintCopySetupData(library call)
NAMEDtPrintCopySetupData — copies one DtPrintSetupData structure to another
SYNOPSIS
#include <Print.h>
DtPrintSetupData* DtPrintCopySetupData(
DtPrintSetupData* target,
const DtPrintSetupData* source);
DESCRIPTION
The DtPrintCopySetupData function copies the DtPrintSetupData structure
pointed to by source to the DtPrintSetupData structure pointed to by
target. Elements in target are updated only if different than the cor‐
responding elements in source.
For elements that point to allocated memory, DtPrintCopySetupData allo‐
cates new memory for those elements updated in target. Existing ele‐
ments in target are freed using XtFree. All elements in a DtPrintSe‐
tupData structure can be freed by calling DtPrintFreeSetupData.
If source or target is NULL, the copy will not be performed.
ARGUMENTS
target A pointer to the DtPrintSetupData structure to copy to.
source A pointer to the DtPrintSetupData structure to copy from.
RETURN VALUE
If DtPrintCopySetupData completes successfully, it returns a pointer to
the target structure. If it fails, it returns a NULL pointer.
ENVIRONMENT VARIABLES
None.
RESOURCES
None.
ACTIONS/MESSAGES
None.
ERRORS/WARNINGS
None.
EXAMPLES
None.
FILES
None.
SEE ALSODtPrintSetupBox(3), DtPrintFreeSetupData(3)
DtPrintCopySetupData(library call)