hpux man page for xfetchbuffer

XFetchBuffer()															    XFetchBuffer()

Name
  XFetchBuffer - return data from a cut buffer.

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

Arguments
  display   Specifies a connection to an X server; returned from XOpenDisplay().

  nbytes_return
	    Returns the number of bytes in buffer returned by XFetchBuffer().  If there is no data in the buffer, *nbytes_return is set to 0.

  buffer    Specifies which buffer you want data from.	Specify an integer from 0 to 7 inclusive.

Returns
  The buffer data.

Description
  XFetchBuffer()  returns  data  from  one of the eight buffers provided for interclient communication.  If the buffer contains data, XFetch-
  Buffer() returns the number of bytes in nbytes_return, otherwise it returns NULL and sets *nbytes_return 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 XFree().	Note that the
  cut buffer does not necessarily contain text, so it may contain embedded null bytes and may not terminate with a null byte.

  Selections are preferred over cut buffers as a communication scheme.

  For more information on cut buffers, see Volume One, Chapter 15, Other Programming Techniques.

Errors
  BadValue  buffer not an integer between 0 and 7 inclusive.

See Also
  XFetchBytes(), XRotateBuffers(), XStoreBuffer(), XStoreBytes().

Xlib - Cut Buffers														    XFetchBuffer()