Manual Pages for UNIX Operating System command usage for man XrmQPutResource

XLIB FUNCTIONS                               XrmPutResource(3x11)



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

SYNTAX
     cc [ flag... ] file... -lX11 [ library... ]

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

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

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

     void XrmQPutStringResource(XrmDatabase *database, XrmBin-
          dingList bindings, XrmQuarkList quarks, char *value);

     void XrmPutLineResource(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 Char-
     acter Encoding, the result is implementation-dependent.  The



X Version 11        Last change: libX11 1.3.5                   1






XLIB FUNCTIONS                               XrmPutResource(3x11)



     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 XrmStringToBin-
     dingQuarkList on the specifier and then calls XrmQPu-
     tResource, 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 con-
     structs 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 data-
     base 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


ATTRIBUTES
     See attributes(5) for descriptions of the following attri-
     butes:






X Version 11        Last change: libX11 1.3.5                   2






XLIB FUNCTIONS                               XrmPutResource(3x11)



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | x11/library/libx11          |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | See XInitThreads(3X11)      |
    |_____________________________|_____________________________|














































X Version 11        Last change: libX11 1.3.5                   3