Museum

 XmInternAtom(Xm)               6 January 1993               XmInternAtom(Xm)


 Name

    XmInternAtom - a function that returns an atom for a given name

 Syntax


    #include <Xm/Xm.h>
    #include <Xm/AtomMgr.h>

    Atom XmInternAtom (display, name, only_if_exists)
    Display * display;
    String name;
    Boolean only_if_exists;


 Description

    XmInternAtom returns an atom for a given name.  It mirrors the Xlib
    interfaces for atom management, but provides client-side caching. When
    and where caching is provided in Xlib, the routines will become pseu-
    donyms for the Xlib routines.

    display Specifies the connection to the X server

    name    Specifies the name associated with the atom you want returned

    onlyifexists
            Specifies a Boolean value that indicates whether XInternAtom cre-
            ates the atom

 Return value

    Returns an atom.