www.sbin.org
XGetAtomNames
Syntax
sStatus XGetAtomNames(display, atoms, count, names_return)
Display *display;
Atom *atoms;
int count;
char **names_return;
Arguments
| display
| Specifies the connection to the X server.
|
| atoms
| Specifies the array of atoms.
|
| count
| Specifies the number of atoms in the array.
|
| names_return
| Returns the atom names.
|
Description
The
XGetAtomNames()
function returns the names associated with the specified atoms.
The names are stored in the names_return array supplied by the caller.
Calling this function is equivalent to calling
XGetAtomName()
for each of the atoms in turn,
but this function minimizes the number of round trip protocol exchanges
between the client and the X server.
This function returns a nonzero status if names are returned for
all of the atoms;
otherwise, it returns zero.
XGetAtomNames()
can generate a
BadAtom
error.
Diagnostics
| BadAtom
| A value for an Atom argument does not name a
defined Atom.
|
See also
XFree(),
XGetAtomName(),
XGetWindowProperty(),
XInternAtom(),
XInternAtoms(),
"Properties and Atoms"
Christophe Tronche, ch.tronche@computer.org