Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   10987 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

XFetchBuffer()							XFetchBuffer()

Name
  XFetchBuffer – return data from a cut buffer.

Synopsis
  char *XFetchBuffer(display, nbytes_return, buffer)
	Display *display;
	int *nbytes_return;
	int buffer;

Arguments
  display   Specifies	a  connection  to  an  X  server;  returned  from
	    XOpenDisplay().

  nbytes_return
	    Returns the number of bytes in  buffer  returned  by  XFetch‐
	    Buffer().	If there is no data in the buffer, *nbytes_return
	    is set to 0.

  buffer    Specifies which buffer you want data from.	Specify an  inte‐
	    ger 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 15,  Other
  Programming Techniques.

Errors
  BadValue  buffer not an integer between 0 and 7 inclusive.

See Also
  XFetchBytes(), XRotateBuffers(), XStoreBuffer(), XStoreBytes().

Xlib - Cut Buffers						XFetchBuffer()

Vote for polarhome