NAME
XFetchBuffer − return data from a cut buffer.
Synopsis
char *XFetchBuffer(display, nbytes_return, buffer)
Display *display;
int *nbytes_return;
int buffer;
Arguments
displaySpecifies 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.
bufferSpecifies which buffer you want data from. Specify an integer from 0 to 7 inclusive.
Description
XFetchBuffer() returns data from one of the 8 buffers provided for interclient communication. If the buffer contains data, XFetchBuffer() 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 13, Other Programming Techniques.
Errors
BadValuebuffer not an integer between 0 and 7 inclusive.
See Also
XFetchBytes(), XRotateBuffers(), XStoreBuffer(), XStoreBytes().
Copyright O’Reilly & Assoc. —