TkInternAtom(3) Tk Library Procedures TkInternAtom(3)

NAME
       TkInternAtom, TkGetAtomName - manage cache of X atoms

SYNOPSIS
       ##iinncclluuddee <>

       Atom
       TTkkIInntteerrnnAAttoomm((tkwin, name)

       CONST char *
       TTkkGGeettAAttoommNNaammee((tkwin, atom)

AARRGGUUMMEENNTTSS
       TkWindow   tkwin    (in)      Token  for  window.  Used to map atom or
                                      name relative to a particular display.

       CONST char  *name    (in)      String name for which atom is desired.

       Atom        atom     (in)      Atom for which corresponding string name
                                      is desired.



DESCRIPTION
       These  procedures  are  similar  to the Xlib procedures XXIInntteerrnnAAttoomm and
       XXGGeettAAttoommNNaammee.  TTkkIInntteerrnnAAttoomm returns  the  atom  identifier  associated
       with  string  given by name;  the atom identifier is only valid for the
       display associated with tkwin.  TTkkGGeettAAttoommNNaammee returns the string asso-
       ciated   with   atom  on  tkwin's  display.   The  string  returned  by
       TTkkGGeettAAttoommNNaammee is in Tk's storage:  the caller need not free this space
       when  finished  with  the  string, and the caller should not modify the
       contents of the returned string.  If there is no atom atom  on  tkwin's
       display, then TTkkGGeettAAttoommNNaammee returns the string ``?bad atom?''.

       Tk  caches the information returned by TTkkIInntteerrnnAAttoomm and TTkkGGeettAAttoommNNaammee
       so that future calls for the same information can be serviced from  the
       cache   without   contacting   the   server.   Thus  TTkkIInntteerrnnAAttoomm  and
       TTkkGGeettAAttoommNNaammee are generally much faster than their Xlib  counterparts,
       and they should be used in place of the Xlib procedures.


KKEEYYWWOORRDDSS
       atom, cache, display



Tk                                                            TkInternAtom(3)