


XrmPutResource(3X11)					 XrmPutResource(3X11)
X11R5									X11R5



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

SYNTAX
  void XrmPutResource(_d_a_t_a_b_a_s_e,	_s_p_e_c_i_f_i_e_r, _t_y_p_e, _v_a_l_u_e)
       XrmDatabase *_d_a_t_a_b_a_s_e;
       char *_s_p_e_c_i_f_i_e_r;
       char *_t_y_p_e;
       XrmValue	*_v_a_l_u_e;

  void XrmQPutResource(_d_a_t_a_b_a_s_e, _b_i_n_d_i_n_g_s, _q_u_a_r_k_s, _t_y_p_e, _v_a_l_u_e)
       XrmDatabase *_d_a_t_a_b_a_s_e;
       XrmBindingList _b_i_n_d_i_n_g_s;
       XrmQuarkList _q_u_a_r_k_s;
       XrmRepresentation _t_y_p_e;
       XrmValue	*_v_a_l_u_e;

  void XrmPutStringResource(_d_a_t_a_b_a_s_e, _s_p_e_c_i_f_i_e_r, _v_a_l_u_e)
       XrmDatabase *_d_a_t_a_b_a_s_e;
       char *_s_p_e_c_i_f_i_e_r;
       char *_v_a_l_u_e;

  void XrmQPutStringResource(_d_a_t_a_b_a_s_e, _b_i_n_d_i_n_g_s, _q_u_a_r_k_s, _v_a_l_u_e)
       XrmDatabase *_d_a_t_a_b_a_s_e;
       XrmBindingList _b_i_n_d_i_n_g_s;
       XrmQuarkList _q_u_a_r_k_s;
       char *_v_a_l_u_e;

  void XrmPutLineResource(_d_a_t_a_b_a_s_e, _l_i_n_e)
       XrmDatabase *_d_a_t_a_b_a_s_e;
       char *_l_i_n_e;

ARGUMENTS

  _b_i_n_d_i_n_g_s  Specifies a	list of	bindings.

  _d_a_t_a_b_a_s_e  Specifies the resource database.

  _l_i_n_e	    Specifies the resource name	and value pair as a single string.

  _q_u_a_r_k_s    Specifies the complete or partial name or the class	list of	the
	    resource.

  _s_p_e_c_i_f_i_e_r Specifies a	complete or partial specification of the resource.

  _t_y_p_e	    Specifies the type of the resource.

  _v_a_l_u_e	    Specifies the value	of the resource, which is specified as a
	    string.


DESCRIPTION
  If database contains NULL, _X_r_m_P_u_t_R_e_s_o_u_r_c_e creates a new database and
  returns a pointer to it.  _X_r_m_P_u_t_R_e_s_o_u_r_c_e is a	convenience function that
  calls	_X_r_m_S_t_r_i_n_g_T_o_B_i_n_d_i_n_g_Q_u_a_r_k_L_i_s_t 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, _X_r_m_Q_P_u_t_R_e_s_o_u_r_c_e 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 value	is replaced
  by the new specified value.  The value is stored in the database without
  modification.

  If database contains NULL, _X_r_m_P_u_t_S_t_r_i_n_g_R_e_s_o_u_r_c_e creates a new	database and
  returns a pointer to it.  _X_r_m_P_u_t_S_t_r_i_n_g_R_e_s_o_u_r_c_e adds a	resource with the
  specified value to the specified database.  _X_r_m_P_u_t_S_t_r_i_n_g_R_e_s_o_u_r_c_e is a	con-
  venience function that first calls _X_r_m_S_t_r_i_n_g_T_o_B_i_n_d_i_n_g_Q_u_a_r_k_L_i_s_t on the
  specifier and	then calls _X_r_m_Q_P_u_t_R_e_s_o_u_r_c_e, 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, _X_r_m_Q_P_u_t_S_t_r_i_n_g_R_e_s_o_u_r_c_e creates a new database and
  returns a pointer to it.  _X_r_m_Q_P_u_t_S_t_r_i_n_g_R_e_s_o_u_r_c_e is a convenience routine
  that constructs an _X_r_m_V_a_l_u_e for the value string (by calling _s_t_r_l_e_n to com-
  pute the size) and then calls	_X_r_m_Q_P_u_t_R_e_s_o_u_r_c_e, using a ``String'' represen-
  tation type.	The value is stored in the database without modification.

  If database contains NULL, _X_r_m_P_u_t_L_i_n_e_R_e_s_o_u_r_c_e	creates	a new database and
  returns a pointer to it.  _X_r_m_P_u_t_L_i_n_e_R_e_s_o_u_r_c_e adds a single resource entry
  to the specified database.  The line must be in valid	ResourceLine format
  (see section 15.1).  The string is parsed in the locale of the database.
  If the _R_e_s_o_u_r_c_e_N_a_m_e 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)
  _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e



























