NAME

XmuInternAtom − get Atoms for an array of strings. 

SYNOPSIS

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

Inputs

dSpecifies a connection to an X server; returned from XOpenDisplay(). 

namesSpecifies the strings to intern. 

countSpecifies the number of strings. 

Outputs

atoms
Returns the array of Atoms.  This array must be allocated by the caller.

DESCRIPTION

XmuInternStrings() converts a list of strings into a list of Atoms, possibly by querying the server.  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 of Atoms. 

USAGE

Atoms are used when requesting or converting selection values in a widget or an application.  This and the related Xmu Atom functions provide client-side caching and help avoid roundtrips to the server.  There are also a number of very useful predefined Atom macros in <X11/Xmu/Atoms.h>.  These macros (XA_TEXT(d), for example) each take a display argument and return the appropriate Atom for that display.  They are named to complement the predefined Atoms from <X11/Xatom.h>. 

SEE ALSO

XmuGetAtomName(6), XmuInternAtom(6), XmuMakeAtom(6), XmuNameofAtom(6).