Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

xtappreleasecacherefs(3xt) [osf1 man page]

XtAppReleaseCacheRefs(3Xt)												XtAppReleaseCacheRefs(3Xt)

NAME
XtAppReleaseCacheRefs - decrement reference counts for resources SYNOPSIS
void XtAppReleaseCacheRefs(app_context, refs) XtAppContext app_context; XtCacheRef* refs; ARGUMENTS
Specifies the application context. 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 XtAppReleaseCacheRefs(3Xt)

Check Out this Related Man Page

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

We Also Found This Discussion For You

1. What is on Your Mind?

Throw my Toys out of the Pram!

Hi Folks, Today hasn't been the best one of my career in IT. I've been a contractor for a major utility company for a number of years, on a number of seperate IT contracts mostly Unix. The company had 10 different flavours of unix and multiple different varsions of most of them. At the... (3 Replies)
Discussion started by: gull04
3 Replies