tk_freexid(3tk) [opensolaris man page]

Tk_FreeXId(3TK) 					       Tk Library Procedures						   Tk_FreeXId(3TK)

__________________________________________________________________________________________________________________________________________________

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 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_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 proce-
       dure, 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

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +--------------------+-----------------+
       |  ATTRIBUTE TYPE    | ATTRIBUTE VALUE |
       +--------------------+-----------------+
       |Availability	    | SUNWTk	      |
       +--------------------+-----------------+
       |Interface Stability | Uncommitted     |
       +--------------------+-----------------+
NOTES

       Source for Tk is available on http://opensolaris.org.

Tk									4.0							   Tk_FreeXId(3TK)

Check Out this Related Man Page

Tk_GetUid(3TK)						       Tk Library Procedures						    Tk_GetUid(3TK)

__________________________________________________________________________________________________________________________________________________

NAME

       Tk_GetUid, Tk_Uid - convert from string to unique identifier

SYNOPSIS

       #include <tk.h>

       Tk_Uid
       Tk_GetUid(string)

ARGUMENTS

       char	    *string	       (in)	 String for which the corresponding unique identifier is desired.
_________________________________________________________________

DESCRIPTION

       Tk_GetUid  returns  the	unique identifier corresponding to string.  Unique identifiers are similar to atoms in Lisp, and are used in Tk to
       speed up comparisons and searches.  A unique identifier (type Tk_Uid) is a string pointer and may be used anywhere that a variable of  type
       ``char  *''  could  be used.  However, there is guaranteed to be exactly one unique identifier for any given string value.  If Tk_GetUid is
       called twice, once with string a and once with string b, and if a and b have the same string value (strcmp(a, b) == 0), then Tk_GetUid will
       return  exactly	the  same Tk_Uid value for each call (Tk_GetUid(a) == Tk_GetUid(b)).  This means that variables of type Tk_Uid may be com-
       pared directly (x == y) without having to call strcmp.  In addition, the return value from Tk_GetUid will have the same string value as its
       argument (strcmp(Tk_GetUid(a), a) == 0).

KEYWORDS

       atom, unique identifier

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +--------------------+-----------------+
       |  ATTRIBUTE TYPE    | ATTRIBUTE VALUE |
       +--------------------+-----------------+
       |Availability	    | SUNWTk	      |
       +--------------------+-----------------+
       |Interface Stability | Uncommitted     |
       +--------------------+-----------------+
NOTES

       Source for Tk is available on http://opensolaris.org.

Tk																    Tk_GetUid(3TK)

Linux and UNIX Man Pages

tk_freexid(3tk) [opensolaris man page]

Check Out this Related Man Page