XmuGtAtmNme(3X) — DeltaWindows 1.3.3 Release 4 Version 4.3

NAME

XmuGetAtomName − returns the string corresponding to the specified Atom.

SYNOPSIS

#include <X11/Xmu/Atoms.h>

char ∗XmuGetAtomName(d, atom)
Display ∗d;
Atom atom;

Inputs

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

atomSpecifies the Atom whose name is desired.

Returns

The string that is interned for the specified Atom on the specified display.

DESCRIPTION

XmuGetAtomName() returns the string corresponding to the specified Atom. The result is cached, so that subsequent requests do not cause another round trip to the server. If the Atom is zero, XmuGetAtomName() returns the string "(BadAtom)".

USAGE

Atoms are used when requesting or converting selection values in a widget or an application. This and the related Xmu Atom functions provide client-side caching and help avoid roundtrips to the server. There are also a number of very useful predefined Atom macros in <X11/Xmu/Atoms.h>. These macros (XA_TEXT(d), for example) each take a display argument and return the appropriate Atom for that display. They are named to complement the predefined Atoms from <X11/Xatom.h>.

Museum