SETBUFFER(3) NEWLIB SETBUFFER(3)NAME
4.55 `setbuffer'--specify full buffering for a file or stream with size
SYNOPSIS
#include <stdio.h>
void setbuffer(FILE *FP, char *BUF, int SIZE);
DESCRIPTION
`setbuffer' specifies that output to the file or stream identified by
FP should be fully buffered. All output for this file will go to a
buffer (of size SIZE). Output will be passed on to the host system
only when the buffer is full, or when an input operation intervenes.
You may, if you wish, supply your own buffer by passing a pointer to
it as the argument BUF. It must have size SIZE. You can also use
`NULL' as the value of BUF, to signal that the `setbuffer' function is
to allocate the buffer.
*Warnings*
You may only use `setbuffer' before performing any file operation other
than opening the file.
If you supply a non-null BUF, you must ensure that the associated
storage continues to be available until you close the stream identified
by FP.
RETURNS
`setbuffer' does not return a result.
PORTABILITY
This function comes from BSD not ANSI or POSIX.
Supporting OS subroutines required: `close', `fstat', `isatty',
`lseek', `read', `sbrk', `write'.
SEE ALSOsetbuffer is part of the library. The full documentation for is main‐
tained as a Texinfo manual. If info and are properly installed at your
site, the command
info
will give you access to the complete manual.
NEWLIB April 2010 SETBUFFER(3)
