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