Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
buffer(3)		   Library Functions Manual		     buffer(3)

NAME
       buffer.h	- generic read/write buffering

SYNTAX
       #include	<buffer.h>

	 buffer* buffer_0;   /*	like stdio's stdin */
	 buffer* buffer_1;   /*	like stdio's stdout */
	 buffer* buffer_2;   /*	like stdio's stderr */

DESCRIPTION
       buffer.h	 provides a generic buffer interface that can be used for read
       and write buffering.  Buffers must be initialized with buffer_init.

       A buffer	can only be used for reading or	writing	at the same time,  not
       both.

       Unlike stdio, these write buffers are not flushed automatically at pro-
       gram  termination;  you	 must	manually   call	  buffer_flush,	  buf-
       fer_putsflush, buffer_putflush or buffer_putnlflush.

EXAMPLE
       See  buffer_init(3) for example read buffer code.  Here is typical code
       for printing an error message on	stderr:

	 #include <buffer.h>

	 buffer_puts(buffer_2,"error: got only ");
	 buffer_putulong(buffer_2,got);
	 buffer_puts(buffer_2,"	bytes, but expected at least ");
	 buffer_putulong(buffer_2,expected);
	 buffer_putsflush(buffer_2," bytes!");

SEE ALSO
       buffer_init(3), buffer_put(3), buffer_get(3), buffer_flush(3)

								     buffer(3)

NAME | SYNTAX | DESCRIPTION | EXAMPLE | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=libowfat_buffer&sektion=3&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help