xtcallbackf(3) [hpux man page]

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.

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 con-
  version 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 XtCallbackReleaseCacheRefList().

Structures
  XtCacheRef is an opaque type.

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

Xt - Resource Management											       XtCallbackReleaseCacheRef()

XtAppReleaseCacheRefs() 												   XtAppReleaseCacheRefs()

Name
  XtAppReleaseCacheRefs - 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.

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 reg-
  istered with an XtCacheRef or an array of XtCacheRef	on the destroy callback of a widget or object  to  automatically  call	XtAppRelease-
  CacheRefs() 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).

Xt - Resource Management												   XtAppReleaseCacheRefs()