The Microsoft Input/Output Stream Classes (iostream.hlp) (Table of Contents; Topic list)
ifstream::setbuf
ifstream                                    Up Contents Index Back
──The Microsoft iostream Classes────────────────────────────────────────────
 
  streambuf* setbuf( char* pch, int nLength );
 
  Parameter   Description
 
  <pch>       A pointer to a previously allocated reserve area of length
              <nLength>. A NULL value indicates an unbuffered stream.
 
  <nLength>   The length (in bytes) of the reserve area. A length of 0
              indicates an unbuffered stream.
 
  Remarks
 
  Attaches the specified reserve area to the stream's filebuf object. If
  the file is open and a buffer has already been allocated, the function
  returns NULL; otherwise it returns a pointer to the filebuf, which is
  cast as a streambuf. The reserve area will not be released by the
  destructor.
 
 
                                     -♦-