


XmInternAtom(3X)					     XmInternAtom(3X)
OSF/Motif							    OSF/Motif



NAME
  XXmmIInntteerrnnAAttoomm - A function that returns an atom for a given name

SYNOPSIS


  ##iinncclluuddee <<XXmm//XXmm..hh>>
  ##iinncclluuddee <<XXmm//AAttoommMMggrr..hh>>
  AAttoomm XXmmIInntteerrnnAAttoomm ((_d_i_s_p_l_a_y, _n_a_m_e, _o_n_l_y__i_f__e_x_i_s_t_s))
       DDiissppllaayy	 * _d_i_s_p_l_a_y;;
       SSttrriinngg	 _n_a_m_e;;
       BBoooolleeaann	 _o_n_l_y__i_f__e_x_i_s_t_s;;

DESCRIPTION
  XXmmIInntteerrnnAAttoomm returns an atom for a given name.  It mirrors the XXlliibb inter-
  faces	for atom management, but provides client-side caching.	When and
  where	caching	is provided in XXlliibb, the routines will become pseudonyms for
  the XXlliibb routines.

  _d_i_s_p_l_a_y   Specifies the connection to	the X server

  _n_a_m_e	    Specifies the name associated with the atom	you want returned

  _o_n_l_y__i_f__e_x_i_s_t_s
	    Specifies a	Boolean	value that indicates whether XXIInntteerrnnAAttoomm
	    creates the	atom

RETURN VALUE
  Returns an atom.





























