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

Если s является нулевым указателем и n равен нулю, filebuf становится небуферизованным для вывода, что означает pbase() и pptr() являются нулевыми и любой вывод немедленно отправляется в файл.

В противном случае вызов setbuf() заменяет внутренний буфер (управляемую последовательность символов) на предоставленный пользователем массив символов, на первый элемент которого указывает s , и позволяет этому объекту std::basic_filebuf использовать до n байтов в этом массиве для буферизации.

Эта функция защищена и виртуальна, она может быть вызвана только через pubsetbuf() или из функций-членов пользовательского класса, производного от std::basic_filebuf .

Параметры

Возвращаемое значение

this

Примечания

Условия, при которых эта функция может быть использована, и способ использования предоставленного буфера определяются реализацией.

• GCC 4.6 libstdc++

setbuf() может быть вызван только тогда, когда std::basic_filebuf не ассоциирован с файлом (в противном случае не оказывает эффекта). При использовании пользовательского буфера чтение из файла читает n-1 байт за раз.

• Clang++3.0 libc++

setbuf() может быть вызвана после открытия файла, но до любых операций ввода-вывода (в противном случае может произойти сбой). При использовании пользовательского буфера чтение из файла считывает наибольшие кратные 4096, которые помещаются в буфер.

• Visual Studio 2010

setbuf() может быть вызван в любое время, даже после выполнения некоторых операций ввода-вывода. Текущее содержимое буфера, если оно есть, теряется.

Стандарт не определяет никакого поведения для этой функции, за исключением того, что setbuf ( 0 , 0 ) вызванная до выполнения любых операций ввода-вывода должна установить небуферизованный вывод.

Пример

#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';
}

356010

Отчёты о дефектах

Следующие отчеты о дефектах, изменяющих поведение, были применены ретроактивно к ранее опубликованным стандартам C++.

Смотрите также