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

objectSpecifies the object with which the resource is associated. 

client_data
Specifies the conversion cache entry to be released.

call_dataIs ignored. 

Availability

Release 4 and later. 

Description

XtCallbackReleaseCacheRef() 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 conversion and automatically registers this function on the object’s destroy callback list if necessary.  To release an array of XtCacheRef, you can use XtCallbackReleaseCacheRefList(). 

Structures

XtCacheRef is an opaque type. 

See Also

XtAppReleaseCacheRefs(1), XtCallbackReleaseCacheRefList(1), XtCallConverter(1), XtConvertAndStore(1). 
 

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