std::setbuf

void setbuf( std::FILE* stream, char* buffer );

Устанавливает внутренний буфер для операций ввода-вывода, выполняемых на потоке C stream.

Если buffer не равен нулю, эквивалентно std::setvbuf(stream, buffer, _IOFBF, BUFSIZ).

Если buffer равен нулю, эквивалентно std::setvbuf(stream, nullptr, _IONBF, 0) , что отключает буферизацию.

Параметры

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

(нет)

Примечания

Если размер буфера BUFSIZ не соответствует требованиям, можно использовать std::setvbuf для его изменения.

Также следует использовать std::setvbuf для обнаружения ошибок, так как std::setbuf не указывает на успех или неудачу.

Эта функция может быть использована только после того, как stream был связан с открытым файлом, но до выполнения любой другой операции (кроме неудачного вызова std::setbuf/std::setvbuf).

Частой ошибкой является установка буфера для stdin или stdout в массив, срок жизни которого заканчивается до завершения программы:

int main()
{
    char buf[BUFSIZ];
    std::setbuf(stdin, buf);
} // lifetime of buf ends, undefined behavior

Пример

#include <chrono>
#include <cstdio>
#include <thread>
 
int main()
{
    using namespace std::chrono_literals;
 
    std::setbuf(stdout, nullptr); // unbuffered stdout
    std::putchar('a'); // appears immediately on unbuffered stream
    std::this_thread::sleep_for(1s);
    std::putchar('b');
}

ab

См. также