NAME

XGetAtomName — get a string name for a property given its atom. 

SYNOPSIS

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

ARGUMENTS

displaySpecifies a connection to an X server; returned from XOpenDisplay(). 

atomSpecifies the atom whose string name you want returned. 

RETURNS

The atom name string. 

DESCRIPTION

An atom is a number identifying a property.  Properties also have a string name.  XGetAtomName() returns the string name that was specified in the original call to XInternAtom() that returned this atom, or, for predefined atoms, a string version of the symbolic constant without the XA_ is returned.  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.  If the specified atom is not defined, XGetAtomName() returns NULL, and generates a BadAtom error. 

For example, XGetAtomName() returns "XA_WM_CLASS" (a string) when passed the predefined atom XA_WM_CLASS (a defined constant). 

You should free the resulting string with XFree() when it is no longer needed. 

XInternAtom() performs the inverse function, returning the atom given the string. 

ERRORS

BadAtom

SEE ALSO

XChangeProperty(), XDeleteProperty(), XGetFontProperty(), XGetWindowProperty(), XInternAtom(), XListProperties(), XRotateWindowProperties(), XSetStandardProperties(). 

Xlib Reference Manual