


XStoreBytes(3X11)					    XStoreBytes(3X11)
X11R5									X11R5



NAME
  XStoreBytes, XStoreBuffer, XFetchBytes, XFetchBuffer,	XRotateBuffers -
  manipulate cut and paste buffers

SYNTAX
  XStoreBytes(_d_i_s_p_l_a_y, _b_y_t_e_s, _n_b_y_t_e_s)
	Display	*_d_i_s_p_l_a_y;
	char *_b_y_t_e_s;
	int _n_b_y_t_e_s;

  XStoreBuffer(_d_i_s_p_l_a_y,	_b_y_t_e_s, _n_b_y_t_e_s, _b_u_f_f_e_r)
	Display	*_d_i_s_p_l_a_y;
	char *_b_y_t_e_s;
	int _n_b_y_t_e_s;
	int _b_u_f_f_e_r;

  char *XFetchBytes(_d_i_s_p_l_a_y, _n_b_y_t_e_s__r_e_t_u_r_n)
	Display	*_d_i_s_p_l_a_y;
	int *_n_b_y_t_e_s__r_e_t_u_r_n;

  char *XFetchBuffer(_d_i_s_p_l_a_y, _n_b_y_t_e_s__r_e_t_u_r_n, _b_u_f_f_e_r)
	Display	*_d_i_s_p_l_a_y;
	int *_n_b_y_t_e_s__r_e_t_u_r_n;
	int _b_u_f_f_e_r;

  XRotateBuffers(_d_i_s_p_l_a_y, _r_o_t_a_t_e)
	Display	*_d_i_s_p_l_a_y;
	int _r_o_t_a_t_e;

ARGUMENTS

  _b_u_f_f_e_r    Specifies the buffer in which you want to store the	bytes or from
	    which you want the stored data returned.

  _b_y_t_e_s	    Specifies the bytes, which are not necessarily ASCII or null-
	    terminated.

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

  _n_b_y_t_e_s    Specifies the number of bytes to be	stored.

  _n_b_y_t_e_s__r_e_t_u_r_n
	    Returns the	number of bytes	in the buffer.

  _r_o_t_a_t_e    Specifies how much to rotate the cut buffers.

DESCRIPTION
  Note that the	data can have embedded null characters,	and need not be	null
  terminated.  The cut buffer's	contents can be	retrieved later	by any client
  calling _X_F_e_t_c_h_B_y_t_e_s.


  _X_S_t_o_r_e_B_y_t_e_s can generate a _B_a_d_A_l_l_o_c error.

  If an	invalid	buffer is specified, the call has no effect.  Note that	the
  data can have	embedded null characters, and need not be null terminated.


  _X_S_t_o_r_e_B_u_f_f_e_r can generate a _B_a_d_A_l_l_o_c error.

  The _X_F_e_t_c_h_B_y_t_e_s function returns the number of bytes in the nbytes_return
  argument, if the buffer contains data.  Otherwise, the function returns
  NULL and sets	nbytes to 0.  The appropriate amount of	storage	is allocated
  and the pointer returned.  The client	must free this storage when finished
  with it by calling _X_F_r_e_e.

  The _X_F_e_t_c_h_B_u_f_f_e_r function returns zero to the	nbytes_return argument if
  there	is no data in the buffer or if an invalid buffer is specified.

  _X_F_e_t_c_h_B_u_f_f_e_r can generate a _B_a_d_V_a_l_u_e error.

  The _X_R_o_t_a_t_e_B_u_f_f_e_r_s function rotates the cut buffers, such that buffer	0
  becomes buffer n, buffer 1 becomes n + 1 mod 8, and so on.  This cut buffer
  numbering is global to the display.  Note that _X_R_o_t_a_t_e_B_u_f_f_e_r_s	generates
  _B_a_d_M_a_t_c_h errors if any of the	eight buffers have not been created.

  _X_R_o_t_a_t_e_B_u_f_f_e_r_s can generate a	_B_a_d_M_a_t_c_h error.

DIAGNOSTICS

  _B_a_d_A_l_l_o_c  The	server failed to allocate the requested	resource or server
	    memory.

  _B_a_d_A_t_o_m   A value for	an Atom	argument does not name a defined Atom.

  _B_a_d_M_a_t_c_h  Some argument or pair of arguments has the correct type and	range
	    but	fails to match in some other way required by the request.

  _B_a_d_V_a_l_u_e  Some numeric value falls outside the range of values accepted by
	    the	request.  Unless a specific range is specified for an argu-
	    ment, the full range defined by the	argument's type	is accepted.
	    Any	argument defined as a set of alternatives can generate this
	    error.

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



























