X Version 11 (Release 6.1)

XmuAtom(X3xmu)

XmuAtom -- Xmu atom functions and macros

Synopsis

cc . . . -lXmu

#include <X11/Xmu/Atoms.h>

AtomPtr XmuMakeAtom(name)
      char * name;

char *XmuNameOfAtom(atom_ptr)
      AtomPtr atom_ptr;

Atom XmuInternAtom(d, atom_ptr)
      Display *d;
      AtomPtr atom_ptr;

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

void XmuInternStrings(d, names, count, atoms)
      Display *d;
      String *names;
      Cardinal count;
      Atom *atoms;

XA_ATOM_PAIR(d)
XA_CHARACTER_POSITION(d)
XA_CLASS(d)
XA_CLIENT_WINDOW(d)
XA_CLIPBOARD(d)
XA_COMPOUND_TEXT(d)
XA_DECNET_ADDRESS(d)
XA_DELETE(d)
XA_FILENAME(d)
XA_HOSTNAME(d)
XA_IP_ADDRESS(d)
XA_LENGTH(d)
XA_LIST_LENGTH(d)
XA_NAME(d)
XA_NET_ADDRESS(d)
XA_NULL(d)
XA_OWNER_OS(d)
XA_SPAN(d)
XA_TARGETS(d)
XA_TEXT(d)
XA_TIMESTAMP(d)
XA_USER(d)

Arguments

atom: Specifies the atom whose name is desired.
atoms: Returns the list of Atom values.
atom_ptr: Specifies the AtomPtr.
count: Specifies the number of strings.
d: Specifies the connection to the X server.
name: Specifies the atom name.
names: Specifies the strings to intern.

Description

The XmuMakeAtom function creates and initializes an opaque object, an AtomPtr, for an Atom with the given name.

XmuNameOfAtom can be used to cache the Atom value for one or more displays. The function returns the name of an AtomPtr.

The XmuInternAtom function returns the Atom for an AtomPtr. The Atom is cached, such that subsequent requests do not cause another round-trip to the server.

The XmuGetAtomName function returns the name of an Atom. The result is cached, such that subsequent requests do not cause another round-trip to the server.

The XmuInternStrings function converts a list of atom names into Atom values. The results are cached, such that subsequent requests do not cause further round-trips to the server. The caller is responsible for preallocating the array pointed at by atoms.

These ``XA_'' macros take a display as an argument and return an Atom. The name of the atom is obtained from the macro name by removing the leading characters ``XA_''. The Atom value is cached, such that subsequent requests do not cause another round-trip to the server.

References

Xlib - C Language X Interface