XInternAtom(3X11)         XLIB FUNCTIONS        XInternAtom(3X11)


NAME
       XInternAtom, XGetAtomName - create or return atom names

SYNTAX
       Atom XInternAtom(display, atomname, onlyifexists)
             Display *display;
             char *atomname;
             Bool onlyifexists;

       char *XGetAtomName(display, atom)
             Display *display;
             Atom atom;

ARGUMENTS
       atom      Specifies the atom for the property name you
                 want returned.

       atomname Specifies the name associated with the atom you
                 want returned.

       display   Specifies the connection to the X server.

       onlyifexists
                 Specifies a Boolean value that indicates whether
                 XInternAtom creates the atom.

DESCRIPTION
       The XInternAtom function returns the atom identifier asso-
       ciated with the specified atom_name string.  If
       only_if_exists is False, the atom is created if it does
       not exist.  Therefore, XInternAtom can return None.  If
       the atom name is not in the Host Portable Character Encod-
       ing the result is implementation dependent.  Case matters;
       the strings thing, Thing, and thinG all designate differ-
       ent atoms.  The atom will remain defined even after the
       client's connection closes.  It will become undefined only
       when the last connection to the X server closes.

       XInternAtom can generate BadAlloc and BadValue errors.

       The XGetAtomName function returns the name associated with
       the specified atom.  If the data returned by the server is
       in the Latin Portable Character Encoding, then the
       returned string is in the Host Portable Character Encod-
       ing.  Otherwise, the result is implementation dependent.
       To free the resulting string, call XFree.

       XGetAtomName can generate a BadAtom error.

DIAGNOSTICS
       BadAlloc  The server failed to allocate the requested
                 resource or server memory.

       BadAtom   A value for an Atom argument does not name a



X Version 11                Release 5                           1

XInternAtom(3X11)         XLIB FUNCTIONS        XInternAtom(3X11)


                 defined Atom.

       BadValue  Some numeric value falls outside the range of
                 values accepted by the request.  Unless a spe-
                 cific range is specified for an argument, the
                 full range defined by the argument's type is
                 accepted.  Any argument defined as a set of
                 alternatives can generate this error.

SEE ALSO
       XFree(3X11), XGetWindowProperty(3X11)
       Xlib - C Language X Interface













































X Version 11                Release 5                           2