XtCallbackReleaseCacheRef()XtCallbackReleaseCacheRef()Name
XtCallbackReleaseCacheRef - callback function to release a cached
resource value.
Synopsis
void XtCallbackReleaseCacheRef(object, client_data, call_data)
Widget object;
XtPointer client_data;
XtPointer call_data;
Inputs
object Specifies the object with which the resource is associated.
client_data
Specifies the conversion cache entry to be released.
call_data Is ignored.
Availability
Release 4 and later.
DescriptionXtCallbackReleaseCacheRef() casts its client_data argument to an
XtCacheRef, places it in a NULL-terminated array of XtCacheRef and
passes this array to XtAppReleaseCacheRefs(). XtAppReleaseCacheRefs()
decrements the reference count on the specified object in the resource
conversion cache, and if the count reaches zero it removes the object
from the cache and calls the appropriate destructor procedures.
XtCallbackReleaseCacheRef() is a convenience procedure designed to be
registered on the destroy callback list of a widget or object (which is
why it has third, unused argument).
Usage
XtCacheRef values are returned from calls to XtCallConverter(). The
higher-level converter function XtConvertAndStore() performs the con‐
version and automatically registers this function on the object's
destroy callback list if necessary.
To release an array of XtCacheRef, you can use XtCallbackRelease‐
CacheRefList().
Structures
XtCacheRef is an opaque type.
See AlsoXtAppReleaseCacheRefs(1), XtCallbackReleaseCacheRefList(1), XtCallCon‐
verter(1), XtConvertAndStore(1).
Xt - Resource Management XtCallbackReleaseCacheRef()
