Function CDM_GetAttribute
|
|
|
|
Description:
This function will search all the Attributes that the specified
Collection has, for an Attribute that has the same name as the "Name"
parameter. If such an Attribute is found, the Attribute object is
return. If an Attribute with the specified name does not exist, NULL is
returned. This function will search all the Attributes that the specified
Document has, for an Attribute that has the same name as the "Name"
parameter. If such an Attribute is found, the Attribute object is
return. If an Attribute with the specified name does not exist, NULL is
returned. This function will search all the Attributes that the specified
Annotation object has, for an Attribute that has the same name as the
"Name" parameter. If such an Attribute is found, the Attribute object is
return. If an Attribute with the specified name does not exist, NULL is
returned.
Return Value:
This function returns an Attribute object (of type CDM_Attribute) if an
Attribute named as specified is found. In case that the specified
Attribute does not exist, NULL is returned. Note that the returned object is property of the CDM and should never be
freed or directly modified in any way by the caller. Subsequent calls
of either the C++ or Tcl API can modify the returned object. If the
caller wants to keep a reference to the current state of the returned
object, he must place such a
request by using Tcl_IncrRefCount. When the caller wants to release the
object (and return it to CDM), the functions Tcl_DecrRefCount of
CDM_Free must be used.
This function returns an Attribute object (of type CDM_Attribute) if an
Attribute named as specified is found. In case that the specified
Attribute does not exist, NULL is returned. Note that the returned object is property of the CDM and should never be
freed or directly modified in any way by the caller. Subsequent calls
of either the C++ or Tcl API can modify the returned object. If the
caller wants to keep a reference to the current state of the returned
object, he must place such a
request by using Tcl_IncrRefCount. When the caller wants to release the
object (and return it to CDM), the functions Tcl_DecrRefCount of
CDM_Free must be used.
This function returns an Attribute object (of type CDM_Attribute) if an
Attribute named as specified is found. In case that the specified
Attribute does not exist, NULL is returned. Note that the returned object is property of the CDM and should never be
freed or directly modified in any way by the caller. Subsequent calls
of either the C++ or Tcl API can modify the returned object. If the
caller wants to keep a reference to the current state of the returned
object, he must place such a
request by using Tcl_IncrRefCount. When the caller wants to release the
object (and return it to CDM), the functions Tcl_DecrRefCount of
CDM_Free must be used.
Notes:
This function is equivelant to tip_GetAttribute (Tcl API). This function is equivelant to tip_GetAttribute (Tcl API). This function is equivelant to tip_GetAttribute (Tcl API).
See Also:
CDM_Free, Tcl_DecrRefCount,
Tcl_IncrRefCount,
tip_GetAttribute CDM_Free, Tcl_DecrRefCount,
Tcl_IncrRefCount,
tip_GetAttribute CDM_Free, Tcl_DecrRefCount,
Tcl_IncrRefCount,
tip_GetAttribute
Generated by: petasis@aias on Wed Aug 16 10:31:57 PM EEST 2006.