std::basic_syncbuf

template<
    class CharT,
    class Traits = std::char_traits<CharT>,
    class Allocator = std::allocator<CharT>
> class basic_syncbuf : public std::basic_streambuf<CharT, Traits>

std::basic_syncbuf — это оболочка для std::basic_streambuf (указатель на него передаётся при создании). Она накапливает вывод во внутреннем буфере и атомарно передаёт всё его содержимое обёрнутому буферу при уничтожении и по явному запросу, благодаря чему символы появляются в виде непрерывной последовательности. Она гарантирует отсутствие гонок данных и перемежения символов, отправленных в обёрнутый буфер, если весь остальной вывод в тот же буфер выполняется через экземпляры std::basic_syncbuf, возможно, разные.

Типичная реализация std::basic_syncbuf хранит указатель на обёрнутый std::basic_streambuf, логический флаг, указывающий, будет ли буфер передавать своё содержимое обёрнутому буферу при синхронизации (сбросе), логический флаг, указывающий на отложенный сброс, если политика запрещает вывод при синхронизации, внутренний буфер, использующий Allocator (например, std::string), и указатель на мьютекс, используемый для синхронизации вывода между несколькими потоками, обращающимися к одному и тому же обёрнутому буферу потока (эти мьютексы могут храниться в хеш-таблице, где в качестве ключей используются указатели на объекты std::basic_streambuf).

Как и к другим классам streambuf, к std::basic_syncbuf обычно обращаются только через соответствующий поток, std::osyncstream, а не напрямую.

Предоставляется несколько псевдонимов типов для распространённых типов символов:

Типы-члены

Функции-члены

Функции, не являющиеся членами

Примечания