NAME

setbuf - assign buffering to a stream

SYNOPSIS

#include <stdio_p.h>

setbuf (stream, buf)
FILE *stream;
char *buf;

DESCRIPTION

setbuf is used after a stream has been opened but before it is read or written. It causes the character array buf to be used instead of an automatically allocated buffer. If buf is the constant pointer NULL, input/output will be completely unbuffered.

A manifest constant BUFSIZ tells how big an array is needed: char buf[BUFSIZ]; A buffer is normally obtained from malloc(3P) upon the first getc or putc(3P) on the file, except that output streams directed to terminals, and the standard error stream stderr are normally not bufferd.

A common source of error is allocation of buffer space as an automatic variable in a code block, and then failing to close the stream in the same block.

SEE ALSO

fopen(3P) , getc(3P) , malloc(3P) , putc(3P).