Tk_FreeXId(3Tk)						       Tk_FreeXId(3Tk)

NAME    [Toc]    [Back]

     Tk_FreeXId	- make X resource identifier available for reuse

SYNOPSIS    [Toc]    [Back]

     #include <tk.h>

     Tk_FreeXId(display, id)

ARGUMENTS    [Toc]    [Back]

     Display   *display	  (in)	    Display for	which id was allocated.

     XID       id	  (in)	    Identifier of X resource (window, font,
				    pixmap, cursor, graphics context, or
				    colormap) that is no longer	in use.

DESCRIPTION    [Toc]    [Back]

     The default allocator for resource	identifiers provided by	Xlib is	very
     simple-minded and does not	allow resource identifiers to be re-used.  If
     a long-running application	reaches	the end	of the resource	id space, it
     will generate an X	protocol error and crash.  Tk replaces the default id
     allocator with its	own allocator, which allows identifiers	to be reused.
     In	order for this to work,	Tk_FreeXId must	be called to tell the
     allocator about resources that have been freed.  Tk automatically calls
     Tk_FreeXId	whenever it frees a resource, so if you	use procedures like
     Tk_GetFontStruct, Tk_GetGC, and Tk_GetPixmap then you need	not call
     Tk_FreeXId.  However, if you allocate resources directly from Xlib, for
     example by	calling	XCreatePixmap, then you	should call Tk_FreeXId when
     you call the corresponding	Xlib free procedure, such as XFreePixmap.  If
     you don't call Tk_FreeXId then the	resource identifier will be lost,
     which could cause problems	if the application runs	long enough to lose
     all of the	available identifiers.

KEYWORDS    [Toc]    [Back]

     resource identifier


									PPPPaaaaggggeeee 1111