XInternAtom(3X11)   RISC/os Reference Manual    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 associ-
     ated with the specified atom_name string.  If only_if_exists
     is False, the atom is created if it does not exist.  There-
     fore, 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.

     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.




                         Printed 1/24/91         Release 4 Page 1

XInternAtom(3X11)   RISC/os Reference Manual    XInternAtom(3X11)



     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 gen-
               erate this error.

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













































Release 4 Page 2         Printed 1/24/91