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

bindingsSpecifies a list of bindings. 

databaseSpecifies a pointer to the resource database. 

lineSpecifies the resource value pair as a single string.  A single colon (:) separates the name from the value. 

quarksSpecifies the complete or partial name or the class list of the resource. 

specifierSpecifies a complete or partial specification of the resource. 

typeSpecifies the type of the resource. 

valueSpecifies 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 database contains NULL, XrmQPutResource creates a new database and returns a pointer to it. 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 routine that takes both the resource and value as null-terminated strings, converts them to quarks, and then calls XrmQPutResource, using a “String” representation type. If database contains NULL, XrmQPutStringResource creates a new database and returns a pointer to it. XrmQPutStringResource is a convenience 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. 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. Any white space before or after the name or colon in the line argument is ignored. The value is terminated by a new-line or a NULL character. To allow values to contain embedded new-line characters, a “\n” is recognized and replaced by a new-line character. For example, line might have the value “xterm∗background:green\n”. Null-terminated strings without a new line are also permitted.

SEE ALSO

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

NEWS-OSRelease 3.3