hpux man page for xgetatomnames

XGetAtomNames(3X)						  XLIB FUNCTIONS						 XGetAtomNames(3X)

NAME
       XGetAtomNames - returns the names associated with the specified atoms

SYNTAX
       Status XGetAtomNames(display, atoms, count, names_return)
	     Display *display;
	     Atom *atoms;
	     int count;
	     char **names_return;

ARGUMENTS
       atoms

       display	 Specifies the connection to the X server.  Specifies the array of atoms.

       count	 Specifies the number of atom names 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
       BadAlloc  The server failed to allocate the requested resource or server memory.

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

       BadValue  Some numeric value falls outside the range of values accepted by the request.	Unless a specific range is specified for an argu-
		 ment, the full range defined by the argument's type is accepted.  Any argument defined as a set of alternatives can generate this
		 error.

SEE ALSO
       XInternAtom(3X), AINternAtoms(3X), XGetAtomName(3X)

X Version 11							     Release 6							 XGetAtomNames(3X)