


XrmEnumerateDatabase(3X11)			   XrmEnumerateDatabase(3X11)
X11R5									X11R5



NAME
  XrmEnumerateDatabase - enumerate resource database entries

SYNTAX


  #define

	    _X_r_m_E_n_u_m_A_l_l_L_e_v_e_l_s

			       0


  #define

	    _X_r_m_E_n_u_m_O_n_e_L_e_v_e_l

			       1

  Bool XrmEnumerateDatabase(_d_a_t_a_b_a_s_e, _n_a_m_e__p_r_e_f_i_x, _c_l_a_s_s__p_r_e_f_i_x, _m_o_d_e, _p_r_o_c,
  _a_r_g)
	XrmDatabase _d_a_t_a_b_a_s_e;
	XrmNameList _n_a_m_e__p_r_e_f_i_x;
	XrmClassList _c_l_a_s_s__p_r_e_f_i_x;
	int _m_o_d_e;
	Bool (*_p_r_o_c)();
	XPointer _a_r_g;

ARGUMENTS

  _d_a_t_a_b_a_s_e  Specifies the resource database.

  _n_a_m_e__p_r_e_f_i_x
	    Specifies the resource name	prefix.

  _c_l_a_s_s__p_r_e_f_i_x
	    Specifies the resource class prefix.

  _m_o_d_e	    Specifies the number of levels to enumerate.

  _p_r_o_c	    Specifies the procedure that is to be called for each matching
	    entry.

  _a_r_g	    Specifies the user-supplied	argument that will be passed to	the
	    procedure.

DESCRIPTION
  The _X_r_m_E_n_u_m_e_r_a_t_e_D_a_t_a_b_a_s_e function calls the specified	procedure for each
  resource in the database that	would match some completion of the given
  name/class resource prefix.  The order in which resources are	found is
  implementation-dependent.  If	mode is	_X_r_m_E_n_u_m_O_n_e_L_e_v_e_l, then a	resource must
  match	the given name/class prefix with just a	single name and	class
  appended.  If	mode is	_X_r_m_E_n_u_m_A_l_l_L_e_v_e_l_s, the resource must match the given
  name/class prefix with one or	more names and classes appended.  If the pro-
  cedure returns _T_r_u_e, the enumeration terminates and the function returns
  _T_r_u_e.	 If the	procedure always returns _F_a_l_s_e,	all matching resources are
  enumerated and the function returns _F_a_l_s_e.

  The procedure	is called with the following arguments:

  (*_p_r_o_c)(_d_a_t_a_b_a_s_e, _b_i_n_d_i_n_g_s, _q_u_a_r_k_s, _t_y_p_e, _v_a_l_u_e, _a_r_g)
	  XrmDatabase *_d_a_t_a_b_a_s_e;
	  XrmBindingList _b_i_n_d_i_n_g_s;
	  XrmQuarkList _q_u_a_r_k_s;
	  XrmRepresentation *_t_y_p_e;
	  XrmValue *_v_a_l_u_e;
	  XPointer _c_l_o_s_u_r_e;

  The bindings and quarks lists	are terminated by _N_U_L_L_Q_U_A_R_K.  Note that
  pointers to the database and type are	passed,	but these values should	not
  be modified.

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





























































