std::basic_filebuf<CharT,Traits>::setbuf

protected:
virtual std::basic_streambuf<CharT, Traits>* setbuf( char_type* s, std::streamsize n )

If s is a null pointer and n is zero, the filebuf becomes unbuffered for output, meaning pbase() and pptr() are null and any output is immediately sent to file.

Otherwise, a call to setbuf() replaces the internal buffer (the controlled character sequence) with the user-supplied character array whose first element is pointed to by s and allows this std::basic_filebuf object to use up to n bytes in that array for buffering.

This function is protected virtual, it may only be called through pubsetbuf() or from member functions of a user-defined class derived from std::basic_filebuf.

Parameters

Return value

this.

Notes

The conditions when this function may be used and the way in which the provided buffer is used is implementation-defined.

• GCC 4.6 libstdc++

• Clang++3.0 libc++

• Visual Studio 2010

The standard does not define any behavior for this function except that setbuf(0, 0) called before any I/O has taken place is required to set unbuffered output.

Example

#include <fstream>
#include <iostream>
#include <string>
 
int main()
{
        int cnt = 0;
        std::ifstream file;
        char buf[10241];
 
        file.rdbuf()->pubsetbuf(buf, sizeof buf);
        file.open("/usr/share/dict/words");
 
        for (std::string line; getline(file, line); )
                ++cnt;
        std::cout << cnt << '\n';
}

See also