Allows the user to control buffering for a stream.

#include <stdio.h>

void setbuf (FILE *stream, char *buffer);

Parameters

stream

Pointer to FILE structure; must refer to an open stream file that has not been read or written.

buffer

User-allocated buffer.

Remarks

If the buffer argument is a null pointer, the stream is unbuffered. If not, the buffer must point to a character array of length BUFSIZ. This user-specified buffer is used for I/O buffering instead of the default system-allocated buffer for the given stream.

The stderr stream is unbuffered by default, but may be assigned buffers with setbuf.

Use setvbuf for new code; setbuf is retained for compatibility with existing code.

Return Values

None.

Requirements

See Also

fclose, setvbuf