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. 

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 13, Other Programming Techniques. 

SEE ALSO

XFetchBuffer(), XRotateBuffers(), XStoreBuffer(), XStoreBytes(). 

Xlib Reference Manual