XtCallbackReleaseCacheRefList()XtCallbackReleaseCacheRefList()Name
XtCallbackReleaseCacheRefList - callback function to release a list of
cached values.
Synopsis
void XtCallbackReleaseCacheRefList(object, client_data, call_data)
Widget object;
XtPointer client_data;
XtPointer call_data;
Inputs
object Specifies the object with which the resources are associated.
client_data
Specifies the conversion cache entries to be released.
call_data Is ignored.
Availability
Release 4 and later.
DescriptionXtCallbackReleaseCacheRefList() casts its client_data argument to a
NULL-terminated array of XtCacheRef and passes this array to XtAppRe‐
leaseCacheRefs(). XtAppReleaseCacheRefs() decrements the reference
count on the specified objects in the resource conversion cache, and if
the count reaches zero on any of them it removes the object from the
cache and calls the appropriate destructor procedures.
XtCallbackReleaseCacheReList() 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 XtCallbackReleaseCacheRef() on the
object's destroy callback list if necessary.
To release a single XtCacheRef, you can use XtCallbackRelease‐
CacheRef().
Structures
XtCacheRef is an opaque type.
See AlsoXtAppReleaseCacheRefs(1), XtCallbackReleaseCacheRef(1), XtCallCon‐
verter(1), XtConvertAndStore(1).
Xt - Resource Management XtCallbackReleaseCacheRefList()
