NAME

XtAppReleaseCacheRefs − decrement the reference counts for cached resources obtained from XtCallConverter(). 

Synopsis

void XtAppReleaseCacheRefs(app, refs)

      XtAppContext app;
      XtCacheRef *refs;

Inputs

appSpecifies the application context. 

refsSpecifies a NULL-terminated array of cache references to be decremented. 

Availability

Release 4 and later. 

Description

XtAppReleaseCacheRefs() 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 XtCallbackReleaseCacheRef() 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 XtCallbackReleaseCacheRef() on the object’s destroy callback if needed.  XtCreateWidget() may also register such callbacks. 

Structures

XtCacheRef is an opaque type. 

See Also

XtCallbackReleaseCacheRef(1), XtCallbackReleaseCacheRefList(1), XtCallConverter(1), XtConvertAndStore(1), XtSetTypeConverter(1),
XtDestructor(2). 

Copyright O’Reilly & Assoc.  —  X Toolkit Intrinsics Reference Manual © O’Reilly & Associates