home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-bin / x11r6.1 / man / cat3 / xrmputresource.0 < prev    next >
Encoding:
C/C++ Source or Header  |  1996-10-17  |  5.5 KB  |  133 lines
  1.  
  2.  
  3.  
  4. XrmPutResource(3X11)      XLIB FUNCTIONS     XrmPutResource(3X11)
  5.  
  6.  
  7. NNAAMMEE
  8.        XrmPutResource, XrmQPutResource, XrmPutStringResource,
  9.        XrmQPutStringResource, XrmPutLineResource - store database
  10.        resources
  11.  
  12. SSYYNNTTAAXX
  13.        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)
  14.         XrmDatabase *_d_a_t_a_b_a_s_e;
  15.         char *_s_p_e_c_i_f_i_e_r;
  16.         char *_t_y_p_e;
  17.         XrmValue *_v_a_l_u_e;
  18.  
  19.        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,
  20.        _v_a_l_u_e)
  21.         XrmDatabase *_d_a_t_a_b_a_s_e;
  22.         XrmBindingList _b_i_n_d_i_n_g_s;
  23.         XrmQuarkList _q_u_a_r_k_s;
  24.         XrmRepresentation _t_y_p_e;
  25.         XrmValue *_v_a_l_u_e;
  26.  
  27.        void XrmPutStringResource(_d_a_t_a_b_a_s_e, _s_p_e_c_i_f_i_e_r, _v_a_l_u_e)
  28.         XrmDatabase *_d_a_t_a_b_a_s_e;
  29.         char *_s_p_e_c_i_f_i_e_r;
  30.         char *_v_a_l_u_e;
  31.  
  32.        void XrmQPutStringResource(_d_a_t_a_b_a_s_e, _b_i_n_d_i_n_g_s, _q_u_a_r_k_s,
  33.        _v_a_l_u_e)
  34.         XrmDatabase *_d_a_t_a_b_a_s_e;
  35.         XrmBindingList _b_i_n_d_i_n_g_s;
  36.         XrmQuarkList _q_u_a_r_k_s;
  37.         char *_v_a_l_u_e;
  38.  
  39.        void XrmPutLineResource(_d_a_t_a_b_a_s_e, _l_i_n_e)
  40.         XrmDatabase *_d_a_t_a_b_a_s_e;
  41.         char *_l_i_n_e;
  42.  
  43. AARRGGUUMMEENNTTSS
  44.        _b_i_n_d_i_n_g_s     Specifies a list of bindings.
  45.  
  46.        _d_a_t_a_b_a_s_e     Specifies the resource database.
  47.  
  48.        _l_i_n_e     Specifies the resource name and value pair as a
  49.          single string.
  50.  
  51.        _q_u_a_r_k_s     Specifies the complete or partial name or the
  52.          class list of the resource.
  53.  
  54.        _s_p_e_c_i_f_i_e_r Specifies a complete or partial specification of
  55.          the resource.
  56.  
  57.        _t_y_p_e     Specifies the type of the resource.
  58.  
  59.        _v_a_l_u_e     Specifies the value of the resource, which is
  60.          specified as a string.
  61.  
  62.  
  63.  
  64. X Version 11           Release 6.1                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XrmPutResource(3X11)      XLIB FUNCTIONS     XrmPutResource(3X11)
  71.  
  72.  
  73. DDEESSCCRRIIPPTTIIOONN
  74.        If database contains NULL, _X_r_m_P_u_t_R_e_s_o_u_r_c_e creates a new
  75.        database and returns a pointer to it.  _X_r_m_P_u_t_R_e_s_o_u_r_c_e is a
  76.        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_-
  77.        _L_i_s_t followed by:
  78.  
  79.        XrmQPutResource(database, bindings, quarks, XrmStringToQuark(type), value)
  80. If the specifier and type are not in the Host Portable Character
  81. Encoding, the result is implementation-dependent.  The value is
  82. stored in the database without modification.
  83.  
  84.        If database contains NULL, _X_r_m_Q_P_u_t_R_e_s_o_u_r_c_e creates a new
  85.        database and returns a pointer to it.  If a resource entry
  86.        with the identical bindings and quarks already exists in
  87.        the database, the previous type and value are replaced by
  88.        the new specified type and value.  The value is stored in
  89.        the database without modification.
  90.  
  91.        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
  92.        new database and returns a pointer to it.  _X_r_m_P_u_t_S_t_r_i_n_g_R_e_-
  93.        _s_o_u_r_c_e adds a resource with the specified value to the
  94.        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
  95.        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
  96.        the specifier and then calls _X_r_m_Q_P_u_t_R_e_s_o_u_r_c_e, using a
  97.        ``String'' representation type.    If the specifier is not
  98.        in the Host Portable Character Encoding, the result is
  99.        implementation-dependent.  The value is stored in the
  100.        database without modification.
  101.  
  102.        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
  103.        new database and returns a pointer to it.  _X_r_m_Q_P_u_t_-
  104.        _S_t_r_i_n_g_R_e_s_o_u_r_c_e is a convenience routine that constructs an
  105.        _X_r_m_V_a_l_u_e for the value string (by calling _s_t_r_l_e_n to com-
  106.        pute the size) and then calls _X_r_m_Q_P_u_t_R_e_s_o_u_r_c_e, using a
  107.        ``String'' representation type.    The value is stored in
  108.        the database without modification.
  109.  
  110.        If database contains NULL, _X_r_m_P_u_t_L_i_n_e_R_e_s_o_u_r_c_e creates a
  111.        new database and returns a pointer to it.  _X_r_m_P_u_t_L_i_n_e_R_e_-
  112.        _s_o_u_r_c_e adds a single resource entry to the specified
  113.        database.  The line should be in valid ResourceLine format
  114.        (see section 15.1) terminated by a newline or null charac-
  115.        ter; the database that results from using a string with
  116.        incorrect syntax is implementation-dependent.  The string
  117.        is parsed in the locale of the database.     If the _R_e_s_o_u_r_c_e_-
  118.        _N_a_m_e is not in the Host Portable Character Encoding, the
  119.        result is implementation-dependent.  Note that comment
  120.        lines are not stored.
  121.  
  122. SSEEEE AALLSSOO
  123.        XrmGetResource(3X11), XrmInitialize(3X11), XrmMerge-
  124.        Databases(3X11), XrmUniqueQuark(3X11)
  125.        _X_l_i_b _- _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  126.  
  127.  
  128.  
  129.  
  130. X Version 11           Release 6.1                2
  131.  
  132.  
  133.