xtappreleasecacherefs(3) [suse man page]

XtAppReleaseCacheRefs(3)					   XT FUNCTIONS 					  XtAppReleaseCacheRefs(3)

NAME

       XtAppReleaseCacheRefs - decrement reference counts for resources

SYNTAX

       void XtAppReleaseCacheRefs(XtAppContext app_context, XtCacheRef* refs);

ARGUMENTS

       app_context
		 Specifies the application context.

       refs	 Specifies the list of cache references to be released.

DESCRIPTION

       XtAppReleaseCacheRefs decrements the reference count for the conversion entries identified by the refs argument. This argument is a pointer
       to a NULL-terminated list of XtCacheRef values. If any reference count reaches zero, the destructor, if any, will be called and the
       resource removed from the conversion cache.

SEE ALSO

       X Toolkit Intrinsics - C Language Interface
       Xlib - C Language X Interface

X Version 11							    libXt 1.0.7 					  XtAppReleaseCacheRefs(3)

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()