


XInternAtom(3X11)					    XInternAtom(3X11)
X11R5									X11R5



NAME
  XInternAtom, XGetAtomName - create or	return atom names

SYNTAX
  Atom XInternAtom(_d_i_s_p_l_a_y, _a_t_o_m__n_a_m_e, _o_n_l_y__i_f__e_x_i_s_t_s)
	Display	*_d_i_s_p_l_a_y;
	char *_a_t_o_m__n_a_m_e;
	Bool _o_n_l_y__i_f__e_x_i_s_t_s;

  char *XGetAtomName(_d_i_s_p_l_a_y, _a_t_o_m)
	Display	*_d_i_s_p_l_a_y;
	Atom _a_t_o_m;

ARGUMENTS

  _a_t_o_m	    Specifies the atom for the property	name you want returned.

  _a_t_o_m__n_a_m_e Specifies the name associated with the atom	you want returned.

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

  _o_n_l_y__i_f__e_x_i_s_t_s
	    Specifies a	Boolean	value that indicates whether _X_I_n_t_e_r_n_A_t_o_m
	    creates the	atom.

DESCRIPTION
  The _X_I_n_t_e_r_n_A_t_o_m function returns the atom identifier associated with the
  specified atom_name string.  If only_if_exists is _F_a_l_s_e, the atom is
  created if it	does not exist.	 Therefore, _X_I_n_t_e_r_n_A_t_o_m	can return _N_o_n_e.  If
  the atom name	is not in the Host Portable Character Encoding the result is
  implementation dependent.  Case matters; the strings _t_h_i_n_g, _T_h_i_n_g, and
  _t_h_i_n_G	all designate different	atoms. The atom	will remain defined even
  after	the client's connection	closes.	 It will become	undefined only when
  the last connection to the X server closes.

  _X_I_n_t_e_r_n_A_t_o_m can generate _B_a_d_A_l_l_o_c and	_B_a_d_V_a_l_u_e errors.

  The _X_G_e_t_A_t_o_m_N_a_m_e function returns the	name associated	with the specified
  atom.	 If the	data returned by the server is in the Latin Portable Charac-
  ter Encoding,	then the returned string is in the Host	Portable Character
  Encoding.  Otherwise,	the result is implementation dependent.	 To free the
  resulting string, call _X_F_r_e_e.

  _X_G_e_t_A_t_o_m_N_a_m_e can generate a _B_a_d_A_t_o_m error.

DIAGNOSTICS

  _B_a_d_A_l_l_o_c  The	server failed to allocate the requested	resource or server
	    memory.

  _B_a_d_A_t_o_m   A value for	an Atom	argument does not name a defined Atom.

  _B_a_d_V_a_l_u_e  Some numeric value falls outside the range of values accepted by
	    the	request.  Unless a specific range is specified for an argu-
	    ment, the full range defined by the	argument's type	is accepted.
	    Any	argument defined as a set of alternatives can generate this
	    error.

SEE ALSO
  XFree(3X11), XGetWindowProperty(3X11)
  _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e	delim off































































