Function CDM_MergeAnnotations


Definition:#include <CDM.h>
Prototype:CDM_AnnotationSet CDM_MergeAnnotations(CDM_AnnotationSet Set1, CDM_AnnotationSet Set2);
Arguments:

Set1: First Set (CDM_AnnotationSet)
Set2: Second Set (CDM_AnnotationSet)

C/C++ API Sections
Tcl API Sections
Description
Return Value
Notes
See Also
Index

Description:

This function accepts two Annotation set objects (both of type CDM_AnnotationSet) and returns a new Annotation set object that is the concatenation of the two provided sets. In case of an error, NULL will be returned and an error will be left at the current active interpeter (CDM_Interp).

Note that CDM does not own the returned object: the caller is responsible to use Tcl_DecrRefCount or CDM_Free in order to free the object and the memory associated with it.

Return Value:

This function will create and return a new Annotation set object (of type CDM_AnnotationSet) that will contain the merge of the two provided Annotation set objects.

If an error occurs, then NULL will be returned and an error message will be left at the current active Tcl interpreter (CDM_Interp).

The caller is responsible to free this object through Tcl_DecrRefCount or CDM_Free.

Notes:

This function is equivelant to tip_MergeAnnotations (Tcl API).

See Also:

CDM_Free, Tcl_DecrRefCount, tip_MergeAnnotations


Generated by: petasis@aias on Wed Aug 16 10:31:57 PM EEST 2006.