NAME

XtConvert, XtDirectConvert - invoke resource converters

SYNTAX

void XtConvert(Widget _w, String _f_r_o_m___t_y_p_e, XrmValuePtr _f_r_o_m, String _t_o___t_y_p_e, XrmValuePtr _t_o___r_e_t_u_r_n); void XtDirectConvert(XtConverter _c_o_n_v_e_r_t_e_r, XrmValuePtr _a_r_g_s, Cardinal _n_u_m___a_r_g_s, XrmValuePtr _f_r_o_m, XrmValuePtr _t_o___r_e_t_u_r_n);

ARGUMENTS

the conversion (often NULL)
_a_r_g_s Specifies the argument list that contains the additional arguments needed to perform .
_c_o_n_v_e_r_t_e_r Specifies the conversion procedure that is to be called.
_f_r_o_m Specifies the value to be converted.
_f_r_o_m___t_y_p_e Specifies the source type.
_n_u_m___a_r_g_s Specifies the number of additional arguments (often zero).
_t_o___t_y_p_e Specifies the destination type.
_t_o___r_e_t_u_r_n Returns the converted value.
_w Specifies the widget to use for additional arguments (if any are needed).

DESCRIPTION

The _X_t_C_o_n_v_e_r_t function looks up the type converter registered to convert from_type to to_type, computes any additional arguments needed, and then calls _X_t_D_i_r_e_c_t_C_o_n_v_e_r_t. _X_t_C_o_n_v_e_r_t has been replaced by _X_t_C_o_n_v_e_r_t_A_n_d_S_t_o_r_e.

The _X_t_D_i_r_e_c_t_C_o_n_v_e_r_t function looks in the converter cache to see if this conversion procedure has been called with the specified arguments. If so, it returns a descriptor for information stored in the cache; otherwise, it calls the converter and enters the result in the cache.

Before calling the specified converter, _X_t_D_i_r_e_c_t_C_o_n_v_e_r_t sets the return value size to zero and the return value address to NULL. To determine if the conversion was successful, the client should check to_return.address for non-NULL. _X_t_D_i_r_e_c_t_C_o_n_v_e_r_t has been replaced by _X_t_C_a_l_l_C_o_n_v_e_r_t_e_r.

SEE ALSO

XtAppAddConverter(3Xt), XtStringConversionWarning(3Xt), XtConvertAndStore(3Xt), XtCallConverter(3Xt)
_X _T_o_o_l_k_i_t _I_n_t_r_i_n_s_i_c_s _- _C _L_a_n_g_u_a_g_e _I_n_t_e_r_f_a_c_e
_X_l_i_b _- _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e