Function CDM_SetAssociatedInfo


Definition:#include <CDM.h>
Prototype:int CDM_SetAssociatedInfo(CDM_Collection Collection, Tcl_Obj *Info);
Arguments:

Collection: A Collection object. (CDM_Collection)
Info: A Tcl object holding the information that is to be associated with the specified Collection (Tcl_Obj *)

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

Description:

This function sets the provided Tcl object (of type Tcl_Obj*) as associated information to the specified Collection object. This "associated information" (Tcl object) can contain anything that the user wants to store ("associate") with this Collection. CDM does not modify or use this information in any way.

Return Value:

The return value from this function will be a standart Tcl completion code (of type int) with one of the values TCL_OK and TCL_ERROR. If the requested Collection exists and the information Tcl object is successfully associated with the Collection, then TCL_OK will be returned. In case of an error, the return value will be TCL_ERROR and an error message describing the error will be left at the current Tcl interpreter (CDM_Interp).

Notes:

This function is equivelant to tip_GetAssociatedInfo (Tcl API).

See Also:

CDM_GetAssociatedInfo, CDM_SetComment, CDM_GetComment, CDM_Free, Tcl_DecrRefCount, Tcl_IncrRefCount


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