Index for Section 3X11

Alphabetical listing for X

Bottom of page

XrmMergeDatabases(3X11)
X11R6
NAME
  XrmMergeDatabases, XrmCombineDatabase, XrmCombineFileDatabase - merge
  resource databases

SYNOPSIS
  void XrmMergeDatabases(source_db, target_db)
	  XrmDatabase source_db, *target_db;

  void XrmCombineDatabase(source_db, target_db, override)
	  XrmDatabase source_db, *target_db;
	  Bool override;

  Status XrmCombineFileDatabase(filename, target_db, override)
	  char *filename;
	  XrmDatabase *target_db;
	  Bool override;

ARGUMENTS
  source_db
      Specifies the resource database that is to be merged into the target
      database.

  target_db
      Specifies the resource database into which the source database is to be
      merged.

  filename
      Specifies the resource database file name.

  override
      Specifies whether source entries override target entries.

DESCRIPTION
  Calling the XrmMergeDatabases function is equivalent to calling the
  XrmCombineDatabase function with an override argument of True.

  The XrmCombineDatabase 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 True; otherwise, the entry in source_db is discarded. If target_db
  contains NULL, XrmCombineDatabase 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 modified.

  The XrmCombineFileDatabase 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 True; otherwise, the entry in the 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, XrmCombineFileDatabase 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)

  Xlib -- C Language X Interface

Index for Section 3X11

Alphabetical listing for X

Top of page