NAME

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

SYNTAX

void XrmPutResource(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(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(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(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(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 database 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 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, _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 convenience 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 compute the size) and then calls _X_r_m_Q_P_u_t_R_e_s_o_u_r_c_e, using a ``String'' representation 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 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 _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