XrmPutResource(3X)                             XrmPutResource(3X)



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

SYNOPSIS
     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;

DESCRIPTION
     The XrmPutResource and XrmQPutResource functions store a
     resource specification into the specified database.
     XrmPutResource is a convenience function that calls
     XrmStringToBindingQuarkList(3X) followed by:

        XrmQPutResource(database, bindings, quarks,
                        XrmStringToQuark(type), value)


     XrmPutStringResource adds a resource with a specified value
     to the specified database.  XrmPutStringResource adds a
     resource with the specified value to the specified database.
     XrmPutStringResource is a convenience function that first
     calls XrmStringToBindingQuarkList(3X) on the specifier and
     then calls XrmQPutResource(3X), using a ``String'' represen-



November, 1990                                                  1

XrmPutResource(3X)                             XrmPutResource(3X)



     tation type.

     The XrmQPutStringResource function adds a string resource to
     the specified database, using quarks as the specification.

     XrmPutLineResource adds a single resource entry to the
     specified database.  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 newline or a null
     character.  To allow values to contain embedded newline
     characters, a \n is recognized and replaced by a newline
     character.  For example, line might have the value
     xterm*background:green\n.  Null-terminated strings without a
     newline are also permitted.

     To allow values to contain arbitrary octets, the 4-character
     sequence \nnn, where n is a digit in the range of 0-7, is
     recognized and replaced with a single byte that contains
     this sequence interpreted as an octal number.  For example,
     a value containing a null byte can be stored by specifying
     \000 in the string.

   Arguments
     These functions accept the following arguments:

     bindings
             Specifies a list of bindings.

     database
             Specifies a pointer to the resource database.  For
             all functions described in this manual entry, if da-
             tabase is NULL, a new resource database is created,
             and a pointer to it is returned database.

     line    Specifies the resource value pair as a single string
             in ResourceLine format (see Section 10.11 in
             Xlib - C Language Interface).  A single colon (:)
             separates the name from the value.  Comment lines
             are not stored.

     quarks  Specifies the complete or partial name or class list
             of the class list of the resource to be stored.

     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 speci-
             fied as a string.



2                                                  November, 1990

XrmPutResource(3X)                             XrmPutResource(3X)



SEE ALSO
     XrmGetResource(3X), XrmInitialize(3X),
     XrmMergeDatabases(3X), XrmUniqueQuark(3X)

     Xlib - C Language Interface



















































November, 1990                                                  3