'\"macro stdmacro
.if n .pH g3x11.XPutRes @(#)XPutRes	40.3 of 1/19/90
.ds tk X Toolkit
.ds xT X Toolkit Intrinsics \- C Language Interface
.ds xI Intrinsics
.ds xW Athena X Widgets \- C Language X Toolkit Interface
.ds xL Xlib \- C Language X Interface
.ds xC Inter-Client Communication Conventions Manual
.ds Rn 3
.ds Vn 2.2
.hw XtMake-Geometry-Request XtQuery-Geometry wid-get
.na
.de Ds
.nf
.\\$1D \\$2 \\$1
.ft 1
.ps \\n(PS
.\".if \\n(VS>=40 .vs \\n(VSu
.\".if \\n(VS<=39 .vs \\n(VSp
..
.de De
.ce 0
.if \\n(BD .DF
.nr BD 0
.in \\n(OIu
.if \\n(TM .ls 2
.sp \\n(DDu
.fi
..
.de FD
.LP
.KS
.TA .5i 3i
.ta .5i 3i
.nf
..
.de FN
.fi
.KE
.LP
..
.de IN		\" send an index entry to the stderr
.tm \\n%:\\$1:\\$2:\\$3
..
.de C{
.KS
.nf
.D
.\"
.\"	choose appropriate monospace font
.\"	the imagen conditional, 480,
.\"	may be changed to L if LB is too
.\"	heavy for your eyes...
.\"
.ie "\\*(.T"480" .ft L
.el .ie "\\*(.T"300" .ft L
.el .ie "\\*(.T"202" .ft PO
.el .ie "\\*(.T"aps" .ft CW
.el .ft R
.ps \\n(PS
.ie \\n(VS>40 .vs \\n(VSu
.el .vs \\n(VSp
..
.de C}
.DE
.R
..
.de Pn
.ie t \\$1\fB\^\\$2\^\fR\\$3
.el \\$1\fI\^\\$2\^\fP\\$3
..
.de PN
.ie t \fB\^\\$1\^\fR\\$2
.el \fI\^\\$1\^\fP\\$2
..
.de NT
.ne 7
.ds NO Note
.if \\n(.$>$1 .if !'\\$2'C' .ds NO \\$2
.if \\n(.$ .if !'\\$1'C' .ds NO \\$1
.ie n .sp
.el .sp 10p
.TB
.ce
\\*(NO
.ie n .sp
.el .sp 5p
.if '\\$1'C' .ce 99
.if '\\$2'C' .ce 99
.in +5n
.ll -5n
.R
..
.		\" Note End -- doug kraft 3/85
.de NE
.ce 0
.in -5n
.ll +5n
.ie n .sp
.el .sp 10p
..
.ny0
.nr X
.if \nX=0 .ds x} XrmPutResource 3X11 "9/1/88" "XWIN 3.0" "\&"
.if \nX=1 .ds x} XrmPutResource 3X11 "9/1/88" "XWIN 3.0"
.if \nX=2 .ds x} XrmPutResource 3X11 "" "\&"
.if \nX=3 .ds x} XrmPutResource "" "" "\&"
.TH \*(x}
.SH NAME
XrmPutResource, XrmQPutResource, XrmPutStringResource, XrmQPutStringResource, XrmPutLineResource \- store database resources
.SH SYNTAX
void XrmPutResource\^(\^\fIdatabase\fP, \fIspecifier\fP, \fItype\fP, \fIvalue\fP\^)
.br
     XrmDatabase *\fIdatabase\fP\^;
.br
     char *\fIspecifier\fP\^;
.br
     char *\fItype\fP\^;
.br
     XrmValue *\fIvalue\fP\^;
.LP
void XrmQPutResource\^(\^\fIdatabase\fP, \fIbindings\fP, \fIquarks\fP, \
\fItype\fP, \fIvalue\fP\^)
.br
     XrmDatabase *\fIdatabase\fP\^;
.br
     XrmBindingList \fIbindings\fP\^;
.br
     XrmQuarkList \fIquarks\fP\^;
.br
     XrmRepresentation \fItype\fP\^;
.br
     XrmValue *\fIvalue\fP\^;
.LP
void XrmPutStringResource\^(\^\fIdatabase\fP, \fIspecifier\fP, \fIvalue\fP\^)
.br
     XrmDatabase *\fIdatabase\fP\^;
.br
     char *\fIspecifier\fP\^;
.br
     char *\fIvalue\fP\^;
.LP
void XrmQPutStringResource\^(\^\fIdatabase\fP, \fIbindings\fP, \fIquarks\fP, \
\fIvalue\fP\^)
.br
     XrmDatabase *\fIdatabase\fP\^;
.br
     XrmBindingList \fIbindings\fP\^;
.br
     XrmQuarkList \fIquarks\fP\^;
.br
     char *\fIvalue\fP\^;
.LP
void XrmPutLineResource\^(\^\fIdatabase\fP, \fIline\fP\^)
.br
     XrmDatabase *\fIdatabase\fP\^;
.br
     char *\fIline\fP\^;
.SH ARGUMENTS
.IP \fIbindings\fP 1i
Specifies a list of bindings.
.IP \fIdatabase\fP 1i
Specifies a pointer to the resource database.
.IP \fIline\fP 1i
Specifies the resource value pair as a single string.
A single colon (:) separates the name from the value.
.IP \fIquarks\fP 1i
Specifies the complete or partial name or the class list of the resource.
.IP \fIspecifier\fP 1i
Specifies a complete or partial specification of the resource.
.IP \fItype\fP 1i
Specifies the type of the resource.
.IP \fIvalue\fP 1i
Specifies the value of the resource, which is specified as a string.
.SH DESCRIPTION
If database contains NULL,
.PN XrmPutResource
creates a new database and returns a pointer to it.
.PN XrmPutResource
is a convenience function that calls
.PN XrmStringToBindingQuarkList
followed by:
.LP
.Ds
XrmQPutResource(database, bindings, quarks, XrmStringToQuark(type), value)
.De
.LP
If database contains NULL,
.PN XrmQPutResource
creates a new database and returns a pointer to it.
.LP
If database contains NULL,
.PN XrmPutStringResource
creates a new database and returns a pointer to it.
.PN XrmPutStringResource
adds a resource with the specified value to the specified database.
.PN XrmPutStringResource
is a convenience routine that takes both the resource and value
as null-terminated strings, converts them to quarks, and then calls
.PN XrmQPutResource ,
using a ``String'' representation type.
.LP
If database contains NULL,
.PN XrmQPutStringResource
creates a new database and returns a pointer to it.
.PN XrmQPutStringResource
is a convenience routine that constructs an
.PN XrmValue
for the value string (by calling
.PN strlen
to compute the size) and
then calls
.PN XrmQPutResource ,
using a ``String'' representation type.
.LP
If database contains NULL,
.PN XrmPutLineResource
creates a new database and returns a pointer to it.
.PN 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.
.SH "SEE ALSO"
XrmGetResource(3X11),
.br
XrmInitialize(3X11),
.br
XrmMergeDatabases(3X11),
.br
XrmUniqueQuark(3X11)
.br
\fI\*(xL\fP
