NAME

       Tk_FreeXId  -  make  X  resource  identifier available for
       reuse


SYNOPSIS

       #include <tk.h>

       Tk_FreeXId(display, id)


ARGUMENTS

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

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


DESCRIPTION

       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_Get­
       Font,  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

       resource identifier


Man(1) output converted with man2html