xrmqputresource(3) [hpux man page]

XrmQPutResource()														 XrmQPutResource()

Name
  XrmQPutResource - store a resource specification into a database using quarks.

Synopsis
  void XrmQPutResource(database, bindings, quarks, type, value)
	  XrmDatabase *database;
	  XrmBindingList bindings;
	  XrmQuarkList quarks;
	  XrmRepresentation type;
	  XrmValue *value;

Arguments
  database
	   Specifies  a  pointer to the resource database.  If database contains NULL, a new resource database is created and a pointer to it
	   is returned in database.  If a database is created, it is created in the current locale.

  bindings
	   Specifies a list of bindings for binding together the quarks argument.

  quarks   Specifies the complete or partial name or class list of the resource to be stored.

  type	   Specifies the type of the resource.

  value    Specifies the value of the resource.

Description
  XrmQPutResource() stores a resource specification into the database.	If a resource entry with the identical bindings  and  quarks  already
  exists  in  the database, the previous value is replaced by the new specified value.	The value is stored in the database without modifica-
  tion.

  database can be a previously defined database, as returned by XrmGetStringDatabase(), XrmGetFileDatabase(),  or  from  XrmMergeDatabases().
  If database is NULL, a new database is created and a pointer to it returned in database.

  bindings  and  quarks  together  specify  where  the value should be stored in the database.	See XrmStringToBindingQuarkList() for a brief
  description of binding and quark lists.  See XrmGetResource() for a description of the  resource  manager  naming  conventions  and  lookup
  rules.

  type	is  the  representation type of value.	This provides a way to distinguish between different representations of the same information.
  Representation types are user-defined character strings describing the way the data is represented.  For example, a color may be  specified
  by a color name ("red"), or be coded in a hexadecimal string ("#4f6c84") (if it is to be used as an argument to XParseColor().)  The repre-
  sentation type would distinguish between these two.  Representation types are created from simple character strings by using the macro Xrm-
  StringToRepresentation.  The type XrmRepresentation is actually the same type as XrmQuark, since it is an ID for a string.  The representa-
  tion is stored along with the value in the database, and is returned when the database is accessed.

  value specifies the value of the resource, specified as an XrmValue.

  XrmGetResource() contains the complete description of how data is accessed from the database, and so provides a good perspective on how  it
  is stored.

  For more information, see Volume One, Chapter 13, Managing User Preferences.

Structures
  XrmDatabase is a pointer to an opaque data type.

     typedef enum {
	 XrmBindTightly, XrmBindLoosely
     } XrmBinding, *XrmBindingList;

     typedef int XrmQuark, *XrmQuarkList;
     typedef XrmQuarkList XrmNameList;
     typedef XrmQuark XrmRepresentation;

     typedef struct {
	 unsigned int size;
	 XPointer addr;
     } XrmValue, *XrmValuePtr;

See Also
  XrmDestroyDatabase(),  XrmGetFileDatabase(),	XrmGetResource(),  XrmGetStringDatabase(), XrmInitialize(), XrmMergeDatabases(), XrmParseCom-
  mand(),  XrmPutFileDatabase(),  XrmPutLineResource(),  XrmPutResource(),  XrmPutStringResource(),  XrmQGetResource(),  XrmQGetSearchList(),
  XrmQGetSearchResource(),  XrmQPutStringResource(),  XrmQuarkToString(), XrmStringToBindingQuarkList(), XrmStringToQuarkList(), XrmStringTo-
  Quark(), XrmUniqueQuark().

Xlib - Resource Manager 													 XrmQPutResource()

XrmPutResource(3X11)						  XLIB FUNCTIONS					      XrmPutResource(3X11)

NAME

       XrmPutResource, XrmQPutResource, XrmPutStringResource, XrmQPutStringResource, XrmPutLineResource - store database resources

SYNTAX

       void XrmPutResource(database, specifier, type, value)
	    XrmDatabase *database;
	    char *specifier;
	    char *type;
	    XrmValue *value;

       void XrmQPutResource(database, bindings, quarks, type, value)
	    XrmDatabase *database;
	    XrmBindingList bindings;
	    XrmQuarkList quarks;
	    XrmRepresentation type;
	    XrmValue *value;

       void XrmPutStringResource(database, specifier, value)
	    XrmDatabase *database;
	    char *specifier;
	    char *value;

       void XrmQPutStringResource(database, bindings, quarks, value)
	    XrmDatabase *database;
	    XrmBindingList bindings;
	    XrmQuarkList quarks;
	    char *value;

       void XrmPutLineResource(database, line)
	    XrmDatabase *database;
	    char *line;

ARGUMENTS

       bindings  Specifies a list of bindings.

       database  Specifies the resource database.

       line	 Specifies the resource name and value pair as a single string.

       quarks	 Specifies the complete or partial name or the class list of the resource.

       specifier Specifies a complete or partial specification of the resource.

       type	 Specifies the type of the resource.

       value	 Specifies the value of the resource, which is specified as a string.

DESCRIPTION

       If database contains NULL, XrmPutResource creates a new database and returns a pointer to it.  XrmPutResource is a convenience function
       that calls XrmStringToBindingQuarkList followed by:

       XrmQPutResource(database, bindings, quarks, XrmStringToQuark(type), value)
If the specifier and type are not in the Host Portable Character Encoding, the result is implementation-dependent.  The value is stored in the
database without modification.

       If database contains NULL, XrmQPutResource creates a new database and returns a pointer to it.  If a resource entry with the identical
       bindings and quarks already exists in the database, the previous type and value are replaced by the new specified type and value.  The
       value is stored in the database without modification.

       If database contains NULL, XrmPutStringResource creates a new database and returns a pointer to it.  XrmPutStringResource adds a resource
       with the specified value to the specified database.  XrmPutStringResource is a convenience function that first calls XrmStringToBind-
       ingQuarkList on the specifier and then calls XrmQPutResource, using a ``String'' representation type.  If the specifier is not in the Host
       Portable Character Encoding, the result is implementation-dependent.  The value is stored in the database without modification.

       If database contains NULL, XrmQPutStringResource creates a new database and returns a pointer to it.  XrmQPutStringResource is a conve-
       nience routine that constructs an XrmValue for the value string (by calling strlen to compute the size) and then calls XrmQPutResource,
       using a ``String'' representation type.	The value is stored in the database without modification.

       If database contains NULL, XrmPutLineResource creates a new database and returns a pointer to it.  XrmPutLineResource adds a single
       resource entry to the specified database.  The line should be in valid ResourceLine format (see section 15.1) terminated by a newline or
       null character; the database that results from using a string with incorrect syntax is implementation-dependent.  The string is parsed in
       the locale of the database.  If the ResourceName is not in the Host Portable Character Encoding, the result is implementation-dependent.
       Note that comment lines are not stored.

SEE ALSO

       XrmGetResource(3X11), XrmInitialize(3X11), XrmMergeDatabases(3X11), XrmUniqueQuark(3X11)
       Xlib - C Language X Interface

X Version 11							    Release 6.6 					      XrmPutResource(3X11)