Tk_FreeXId(3)                Tk Library Procedures               Tk_FreeXId(3)


       Tk_FreeXId - make X resource identifier available for reuse

       #include <tk.h>

       Tk_FreeXId(display, id)

       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.

       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 automati-
       cally calls Tk_FreeXId whenever it frees a resource, so if you use pro-
       cedures  like  Tk_GetFont, 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.

       resource identifier

Tk                                    4.0                        Tk_FreeXId(3)