This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

For more information about the manual page format, see the manual page for manpages(5).

Tk_FreeXId(3)                               Tk Library Procedures                              Tk_FreeXId(3)



____________________________________________________________________________________________________________

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, cursor, graphics con-text, context,
                                      text, 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  allo-cator allocator
       cator  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 automatically
       cally  calls  Tk_FreeXId  whenever  it  frees  a  resource, so if you use procedures 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.


KEYWORDS
       resource identifier



Tk                                                   4.0                                       Tk_FreeXId(3)