XInternAtom(3X11)   X Version 11 (Release 4)    XInternAtom(3X11)



  NAME
       XInternAtom, XGetAtomName - create or return atom names

  SYNTAX
       Atom XInternAtom(display, atom_name, only_if_exists)
             Display *display;
             char *atom_name;
             Bool only_if_exists;

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

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

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

       display   Specifies the connection to the X server.

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

  DESCRIPTION
       The XInternAtom function returns the atom identifier
       associated 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.  You should
       use a null-terminated ISO Latin-1 string for atom_name.
       Case matters; the strings thing, Thing, and thinG all
       designate different 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.



  Page 1                                          (printed 8/30/91)

  XInternAtom(3X11)   X Version 11 (Release 4)    XInternAtom(3X11)



       The XGetAtomName function returns the name associated with
       the specified atom.  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
                 defined Atom.

       BadValue  Some numeric value falls outside the range of
                 values accepted by the request.  Unless a specific
                 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



















  Page 2                                          (printed 8/30/91)