XFetchBytes() XFetchBytes()
Name
XFetchBytes - return data from cut buffer 0.
Synopsis
char *XFetchBytes(display, nbytes_return)
Display *display;
int *nbytes_return;
Arguments
display Specifies a connection to an X server; returned from XOpenDisplay().
nbytes_return
Returns the number of bytes in the string returned by XFetchBytes(). If there is no data in the buffer, *nbytes_return is set to
0.
Returns
The buffer data.
Description
XFetchBytes() returns data from cut buffer 0 of the eight buffers provided for interclient communication. If the buffer contains data,
XFetchBytes() 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.
Use XFetchBuffer() to fetch data from any specified cut buffer.
Selections are preferred over cut buffers as a communication method.
For more information on cut buffers, see Volume One, Chapter 15, Other Programming Techniques.
See Also
XFetchBuffer(), XRotateBuffers(), XStoreBuffer(), XStoreBytes().
Xlib - Cut Buffers XFetchBytes()
