NAME
XFetchBytes − return data from cut buffer 0.
Synopsis
char *XFetchBytes(display, nbytes_return)
Display *display;
int *nbytes_return;
Arguments
displaySpecifies 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.
Description
XFetchBytes() returns data from cut buffer 0 of the 8 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 13, Other Programming Techniques.
See Also
XFetchBuffer(), XRotateBuffers(), XStoreBuffer(), XStoreBytes().
Copyright O’Reilly & Assoc. —