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