xrmqputstringresource(3) [hpux man page]
XrmQPutStringResource() XrmQPutStringResource() Name XrmQPutStringResource - add a resource specification to a database using a quark resource name and string value. Synopsis void XrmQPutStringResource(database, bindings, quarks, value) XrmDatabase *database; XrmBindingList bindings; XrmQuarkList quarks; char *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. value Specifies the value of the resource as a string. Description XrmQPutStringResource() stores a resource specification into the specified database. XrmQPutStringResource() is a cross between XrmQPutResource() and XrmPutStringResource(). Like XrmQPutResource(), it specifies the resource by quarks and bindings, two lists that together make a name/class list with loose and tight bindings. Like XrmPutStringResource(), it specifies the value to be stored as a string, that value is converted into an XrmValue, and the default representation type String is used. The value is stored in the database without modification. XrmPutResource(), XrmQPutResource(), XrmPutStringResource(), XrmQPutStringResource() and XrmPutLineResource() all store data into a data- base. See XrmQPutResource() for the most complete description of this process. 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; See Also XrmDestroyDatabase(), XrmGetFileDatabase(), XrmGetResource(), XrmGetStringDatabase(), XrmInitialize(), XrmMergeDatabases(), XrmParseCom- mand(), XrmPutFileDatabase(), XrmPutLineResource(), XrmPutResource(), XrmPutStringResource(), XrmQGetResource(), XrmQGetSearchList(), XrmQGetSearchResource(), XrmQPutResource(), XrmQuarkToString(), XrmStringToBindingQuarkList(), XrmStringToQuarkList(), XrmStringToQuark(), XrmUniqueQuark(). Xlib - Resource Manager XrmQPutStringResource()
Check Out this Related 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()