Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
XStoreBytes(3)			XLIB FUNCTIONS			XStoreBytes(3)

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

       int XStoreBytes(Display *display, _Xconst char *bytes, int nbytes);

       int XStoreBuffer(Display	*display, _Xconst char *bytes, int nbytes, int

       char *XFetchBytes(Display *display, int *nbytes_return);

       char *XFetchBuffer(Display *display, int	*nbytes_return,	int buffer);

       int XRotateBuffers(Display *display, int	rotate);

       buffer	 Specifies  the	buffer in which	you want to store the bytes or
		 from which you	want the stored	data returned.

       bytes	 Specifies the bytes, which are	not necessarily	ASCII or null-

       display	 Specifies the connection to the X server.

       nbytes	 Specifies the number of bytes to be stored.

		 Returns the number of bytes in	the buffer.

       rotate	 Specifies how much to rotate the cut buffers.

       The  data can have embedded null	characters and need not	be null-termi-
       nated.  The cut buffer's	contents can be	retrieved later	by any	client
       calling XFetchBytes.

       XStoreBytes can generate	a BadAlloc error.

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

       XStoreBuffer can	generate a BadAlloc error.

       The XFetchBytes function	returns	the number of bytes in the  nbytes_re-
       turn  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 stor-
       age when	finished with it by calling XFree.

       The XFetchBuffer	function returns zero to the nbytes_return argument if
       there is	no data	in the buffer or if an invalid buffer is specified.

       XFetchBuffer can	generate a BadValue error.

       The XRotateBuffers 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	XRotateBuffers
       generates BadMatch errors if any	of the eight  buffers  have  not  been

       XRotateBuffers can generate a BadMatch error.

       BadAlloc	 The  server  failed  to  allocate  the	 requested resource or
		 server	memory.

       BadAtom	 A value for an	Atom argument does not name a defined Atom.

       BadMatch	 Some argument or pair of arguments has	the correct  type  and
		 range	but  fails  to match in	some other way required	by the

       BadValue	 Some numeric value falls outside the range of values accepted
		 by  the request.  Unless a specific range is specified	for an
		 argument, the full range defined by the  argument's  type  is
		 accepted.   Any argument defined as a set of alternatives can
		 generate this error.

       Xlib - C	Language X Interface

X Version 11			 libX11	1.7.2			XStoreBytes(3)


Want to link to this manual page? Use this URL:

home | help