NAME

XrmPutResource − store a resource specification into a resource database. 

Synopsis

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

Arguments

databaseSpecifies 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. 

specifierSpecifies a complete or partial specification of the resource. 

typeSpecifies the type of the resource. 

valueSpecifies the value of the resource. 

Description

XrmPutResource() is one of several functions which store data into a database.  XrmPutResource() first converts specifier into a binding list and a quark list by calling XrmStringToBindingQuarkList(), and converts type into an XrmRepresentation by calling XrmStringToRepresentation.  Finally, it puts the data into the database.  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.  XrmPutResource(), XrmQPutResource(), XrmPutStringResource(), XrmQPutStringResource() and XrmPutLineResource() all store data into a database.  See the description of XrmQPutResource() for the most complete description of this process.  For more information, see Volume One, Chapter 11, Managing User Preferences. 

Structures

XrmDatabase is a pointer to an opaque data type.
 typedef struct {
    unsigned int    size;
    XPointer        addr;
} XrmValue, *XrmValuePtr;

See Also

XrmDestroyDatabase(), XrmGetFileDatabase(), XrmGetResource(), XrmGetStringDatabase(), XrmInitialize(), XrmMergeDatabases(), XrmParseCommand(), XrmPutFileDatabase(), XrmPutLineResource(), XrmPutStringResource(), XrmQGetResource(), XrmQGetSearchList(), XrmQGetSearchResource(), XrmQPutResource(), XrmQPutStringResource(), XrmQuarkToString(), XrmStringToBindingQuarkList(), XrmStringToQuarkList(), XrmStringToQuark(), XrmUniqueQuark(). 

Copyright O’Reilly & Assoc.  —