buffer(3)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 ALSObuffer_init(3), buffer_put(3), buffer_get(3), buffer_flush(3)buffer(3)
