XInternAtom(3X11)       COMMAND REFERENCE       XInternAtom(3X11)



NAME
     XInternAtom, XGetAtomName - create or return atom names

SYNOPSIS
     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.

     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.



X Version 11            1 September 1988                        1

XInternAtom(3X11)       COMMAND REFERENCE       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
               generate this error.

SEE ALSO
     XGetWindowProperty(3x11)
     Xlib - C Language X Interface













































X Version 11            1 September 1988                        2

%%index%%
na:480,107;
sy:587,1037;
de:1624,1153;
di:2777,1266;
se:4043,304;
%%index%%000000000099