XtAppReleaseCacheRefs()XtAppReleaseCacheRefs()NameXtAppReleaseCacheRefs - decrement the reference counts for cached
resources obtained from XtCallConverter().
Synopsis
void XtAppReleaseCacheRefs(app, refs)
XtAppContext app;
XtCacheRef *refs;
Inputs
app Specifies the application context.
refs Specifies a NULL-terminated array of cache references to be
decremented.
Availability
Release 4 and later.
DescriptionXtAppReleaseCacheRefs() decrements the reference count for each
XtCacheRef in the NULL-terminated array refs. If any reference count
reaches zero, the destructor registered with XtSetTypeConverter() for
that resource type, if any, will be called and the resource removed
from the conversion cache.
An XtCacheRef is a handle to a cached resource value. It is obtained
in a call to XtCallConverter().
Usage
Applications and widgets should very rarely need to call this function.
The Intrinsics provide two predefined callbacks which can be registered
with an XtCacheRef or an array of XtCacheRef on the destroy callback
of a widget or object to automatically call XtAppReleaseCacheRefs()
when the resources are no longer needed. See XtCallbackRelease‐
CacheRef() and XtCallbackReleaseCacheRefList().
Additionally, the function XtConvertAndStore() which is a higher-level
interface to resource converters than XtCallConverter() is passed a
widget or object and automatically registers XtCallbackRelease‐
CacheRef() on the object's destroy callback if needed. XtCreateWid‐
get() may also register such callbacks.
Structures
XtCacheRef is an opaque type.
See AlsoXtCallbackReleaseCacheRef(1), XtCallbackReleaseCacheRefList(1), XtCall‐
Converter(1), XtConvertAndStore(1), XtSetTypeConverter(1),
XtDestructor(2).
Xt - Resource Management XtAppReleaseCacheRefs()
