XStoreBytes(3X) XStoreBytes(3X)NAME XStoreBytes, XStoreBuffer, XFetchBytes, XFetchBuffer, XRotateBuffers - manipulate the cut and paste buffers SYNOPSIS XStoreBytes (display, data, nbytes) Display *display; char data[]; int nbytes; XStoreBuffer (display, data, nbytes, buffer) Display *display; char data[]; int nbytes; int buffer; char *XFetchBytes (display, nbytes-return) Display *display; int *nbytes-return; char *XFetchBuffer (display, nbytes-return, return-buffer) Display *display; int *nbytes-return; int return-buffer; XRotateBuffers (display, rotate) Display *display; int rotate; DESCRIPTION The XStoreBytes function stores data in cut buffer 0. The nbytes argument specifies the number of bytes in data to store. The XStoreBuffer function stores data in the cut buffer specified by buffer, which must be in the range of 0-7. The XFetchBytes function returns information about the pres- ence of data in cut buffer 0. If cut buffer 0 contains data, XFetchBytes returns a pointer to the data and places the number of bytes in cut buffer 0 in the nbytes-return ar- gument. If cut buffer 0 is empty, the function returns NULL and sets *nbytes-return to 0. The XFetchBuffer function returns information about the presence of data in buffer, which must in the range of 0-7. If the specified buffer contains data, XFetchBuffer returns a pointer to the data and places the number of bytes of data in nbytes-return. If the specified buffer is empty, the function returns NULL and sets *nbytes-return to 0. November, 1990 1
XStoreBytes(3X) XStoreBytes(3X)The XRotateBuffers function rotates the cut buffers, so that buffer 0 becomes buffer rotate, buffer 1 becomes rotate+1 mod 8, and so on. The numbering of cut buffers is global to the display. Arguments These functions accept the following arguments: buffer Specifies the buffer in which data is to be stored and must be in the range of 0-7. data Specifies the data to be stored. The data need not be ASCII or null-terminated. display Specifies the connection to the X server. nbytes Specifies the number of bytes in data to store. nbytes-return Returns the number of bytes that are in the cut buffer. rotate Specifies how much to rotate the cut buffers. ERRORS BadAlloc The server failed to allocate the requested resource or server memory. BadAtom A value for an Atom argument does not name a defined atom. BadMatch An argument or pair of arguments has the correct type and range, but fails to match in some other re- quired way. BadValue A numeric value falls outside the range of values accepted by the request. Unless a range is speci- fied for an argument, the full range defined by the argument's type is accepted. Any argument defined as a set of alternatives can generate this error. BadWindow A value for a Window argument does not name a de- fined window. The XStoreBytes function can generate a BadAlloc error. The XStoreBuffer function can generate BadAlloc and BadAtom errors. 2 November, 1990
XStoreBytes(3X) XStoreBytes(3X)The XFetchBuffer function can generate a BadValue error. The XRotateBuffers function can generate a BadMatch error. SEE ALSO Xlib - C Language Interface November, 1990 3