hpux man page for xtcallbackg

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.

Description
  XtCallbackReleaseCacheRefList() 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 XtCallbackReleaseCacheRef().

Structures
  XtCacheRef is an opaque type.

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

Xt - Resource Management											   XtCallbackReleaseCacheRefList()