


XSaveContext(3X11)					   XSaveContext(3X11)
X11R5									X11R5



NAME
  XSaveContext,	XFindContext, XDeleteContext, XUniqueContext - associative
  look-up routines

SYNTAX
  int XSaveContext(_d_i_s_p_l_a_y, _r_i_d, _c_o_n_t_e_x_t, _d_a_t_a)
	Display	*_d_i_s_p_l_a_y;
	XID _r_i_d;
	XContext _c_o_n_t_e_x_t;
	XPointer _d_a_t_a;

  int XFindContext(_d_i_s_p_l_a_y, _r_i_d, _c_o_n_t_e_x_t, _d_a_t_a__r_e_t_u_r_n)
	Display	*_d_i_s_p_l_a_y;
	XID _r_i_d;
	XContext _c_o_n_t_e_x_t;
	XPointer *_d_a_t_a__r_e_t_u_r_n;

  int XDeleteContext(_d_i_s_p_l_a_y, _r_i_d, _c_o_n_t_e_x_t)
	Display	*_d_i_s_p_l_a_y;
	XID _r_i_d;
	XContext _c_o_n_t_e_x_t;

  XContext XUniqueContext()

ARGUMENTS

  _c_o_n_t_e_x_t   Specifies the context type to which	the data belongs.

  _d_a_t_a	    Specifies the data to be associated	with the window	and type.

  _d_a_t_a__r_e_t_u_r_n
	    Returns the	data.

  _d_i_s_p_l_a_y   Specifies the connection to	the X server.

  _r_i_d	    Specifies the resource ID with which the data is associated.

DESCRIPTION
  If an	entry with the specified resource ID and type already exists,
  _X_S_a_v_e_C_o_n_t_e_x_t overrides it with the specified context.	 The _X_S_a_v_e_C_o_n_t_e_x_t
  function returns a nonzero error code	if an error has	occurred and zero
  otherwise.  Possible errors are _X_C_N_O_M_E_M (out of memory).

  Because it is	a return value,	the data is a pointer.	The _X_F_i_n_d_C_o_n_t_e_x_t
  function returns a nonzero error code	if an error has	occurred and zero
  otherwise.  Possible errors are _X_C_N_O_E_N_T (context-not-found).

  The _X_D_e_l_e_t_e_C_o_n_t_e_x_t function deletes the entry	for the	given resource ID and
  type from the	data structure.	 This function returns the same	error codes
  that _X_F_i_n_d_C_o_n_t_e_x_t returns if called with the same arguments.	_X_D_e_l_e_t_e_C_o_n_-
  _t_e_x_t does not	free the data whose address was	saved.

  The _X_U_n_i_q_u_e_C_o_n_t_e_x_t function creates a	unique context type that may be	used
  in subsequent	calls to _X_S_a_v_e_C_o_n_t_e_x_t.




SEE ALSO
  _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
































































