Museum

 XmuAtom(Xmu)      X Version 11 (Release 5) 6 January 1993       XmuAtom(Xmu)


 Name

    XmuAtom - Xmu atom functions and macros

 Syntax


    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.

    atomptr  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 dis-
    plays.  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.

 See also

    Xlib - C Language X Interface