sseettbbuuff() -- STDIO Function (libc)

Set alternative stream buffer
#iinncclluuddee <ssttddiioo.hh>
vvooiidd sseettbbuuff(_f_p, _b_u_f_f_e_r)
FFIILLEE *_f_p; cchhaarr *_b_u_f_f_e_r;

The  standard I/O  library STDIO  automatically buffers  all data  read and
written  in streams,  with the  exception of  streams to  terminal devices.
STDIO normally uses mmaalllloocc() to allocate  the buffer, which is a cchhaarr array
BBUUFFSSIIZZ characters long; BBUUFFSSIIZZ is a manifest constant defined in the header
file ssttddiioo.hh.

sseettbbuuff()'s arguments are the file stream _f_p and the _b_u_f_f_e_r to be associated
with  the stream.   The call  should be  issued after  the stream  has been
opened, but before any input or  output request has been issued.  If _b_u_f_f_e_r
is NULL, the  stream will be unbuffered.  If _b_u_f_f_e_r  is not NULL, the arena
of memory it points to must contain at least BBUUFFSSIIZZ bytes.

sseettbbuuff() returns nothing.

_S_e_e _A_l_s_o
ffooppeenn(), lliibbcc, mmaalllloocc(), sseettvvbbuuff()
ANSI Standard, section 7.9.5.5
POSIX Standard, section 8.1
