


XrmMergeDatabases(3X11)				      XrmMergeDatabases(3X11)
X11R5									X11R5



NAME
  XrmMergeDatabases, XrmCombineDatabase, XrmCombineFileDatabase	- merge
  resource databases

SYNTAX
  void XrmMergeDatabases(_s_o_u_r_c_e__d_b, _t_a_r_g_e_t__d_b)
	XrmDatabase _s_o_u_r_c_e__d_b, *_t_a_r_g_e_t__d_b;

  void XrmCombineDatabase(_s_o_u_r_c_e__d_b, _t_a_r_g_e_t__d_b,	_o_v_e_r_r_i_d_e)
	XrmDatabase _s_o_u_r_c_e__d_b, *_t_a_r_g_e_t__d_b;
	Bool _o_v_e_r_r_i_d_e;

  void XrmCombineFileDatabase(_f_i_l_e_n_a_m_e,	_t_a_r_g_e_t__d_b, _o_v_e_r_r_i_d_e)
	char *_f_i_l_e_n_a_m_e;
	XrmDatabase *_t_a_r_g_e_t__d_b;
	Bool _o_v_e_r_r_i_d_e;

ARGUMENTS

  _s_o_u_r_c_e__d_b Specifies the resource database that is to be merged into the
	    target database.

  _t_a_r_g_e_t__d_b Specifies the resource database into which the source database is
	    to be merged.

  _f_i_l_e_n_a_m_e  Specifies the resource database file name.

DESCRIPTION
  The _X_r_m_M_e_r_g_e_D_a_t_a_b_a_s_e_s	function merges	the contents of	one database into
  another.  If the same	specifier is used for an entry in both databases, the
  entry	in the source_db will replace the entry	in the target_db (that is, it
  overrides target_db).	 If target_db contains NULL, _X_r_m_M_e_r_g_e_D_a_t_a_b_a_s_e_s simply
  stores source_db in it.  Otherwise, source_db	is destroyed by	the merge,
  but the database pointed to by target_db is not destroyed.  The database
  entries are merged without changing values or	types, regardless of the
  locales of the databases.  The locale	of the target database is not modi-
  fied.

  The _X_r_m_C_o_m_b_i_n_e_D_a_t_a_b_a_s_e function merges the contents of one database into
  another.  If the same	specifier is used for an entry in both databases, the
  entry	in the source_db will replace the entry	in the target_db if override
  is _T_r_u_e; otherwise, the entry	in source_db is	discarded.  If target_db con-
  tains	NULL, _X_r_m_C_o_m_b_i_n_e_D_a_t_a_b_a_s_e simply	stores source_db in it.	 Otherwise,
  source_db is destroyed by the	merge, but the database	pointed	to by
  target_db is not destroyed.  The database entries are	merged without chang-
  ing values or	types, regardless of the locales of the	databases.  The
  locale of the	target database	is not modified.

  The _X_r_m_C_o_m_b_i_n_e_F_i_l_e_D_a_t_a_b_a_s_e function merges the contents of a resource	file
  into a database.  If the same	specifier is used for an entry in both the
  file and the database, the entry in the file will replace the	entry in the
  database if override is _T_r_u_e;	otherwise, the entry in	file is	discarded.
  The file is parsed in	the current locale.  If	the file cannot	be read	a
  zero status is returned; otherwise a nonzero status is returned.  If
  target_db contains NULL, _X_r_m_C_o_m_b_i_n_e_F_i_l_e_D_a_t_a_b_a_s_e creates and returns a	new
  database to it.  Otherwise, the database pointed to by target_db is not
  destroyed by the merge.  The database	entries	are merged without changing
  values or types, regardless of the locale of the database.  The locale of
  the target database is not 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





























































