XGetAtomName

Syntax

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

Arguments

display Specifies the connection to the X server.
atom Specifies the atom for the property name you want returned.

Description

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 Encoding. Otherwise, the result is implementation dependent. To free the resulting string, call XFree().

XGetAtomName() can generate a BadAtom error.

Diagnostics

BadAtom A value for an Atom argument does not name a defined Atom.

See also

XFree(), XGetAtomNames(), XGetWindowProperty(), XInternAtom(), XInternAtoms(), "Properties and Atoms"
Christophe Tronche, ch@tronche.com