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. 

RETURNS

The buffer data. 

DESCRIPTION

XFetchBuffer() returns data from one of the eight 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(). 

Xlib Reference Manual