Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
XrmPutResource(3)		 XLIB FUNCTIONS 	       XrmPutResource(3)

NAME
     XrmPutResource,   XrmQPutResource,  XrmPutStringResource,	XrmQPutStringRe-
     source, XrmPutLineResource - store database resources

SYNTAX
     #include <X11/Xresource.h>

     void XrmPutResource(XrmDatabase *database, char *specifier, char *type, Xr-
	    mValue *value);

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

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

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

     void XrmPutLineResource(XrmDatabase *database, _Xconst 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 re-
     turns 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 data-
     base without modification.

     If database contains NULL, XrmQPutResource creates a new database	and  re-
     turns 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 re-
     placed 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 con-
     venience function that first calls XrmStringToBindingQuarkList on the spec-
     ifier 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 convenience routine
     that constructs an XrmValue for the value string (by calling strlen to com-
     pute the size) and then calls XrmQPutResource, using a "String" representa-
     tion 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 Re-
     sourceName is not in the Host Portable Character Encoding,  the  result  is
     implementation-dependent.	Note that comment lines are not stored.

SEE ALSO
     XrmGetResource(3),   XrmInitialize(3),   XrmMergeDatabases(3),   XrmUnique-
     Quark(3)
     Xlib - C Language X Interface

X Version 11			  libX11 1.8.13 	       XrmPutResource(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=XrmPutResource&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help