std:: basic_syncbuf

Определено в заголовочном файле <syncstream>
template < class CharT, class Traits = std:: char_traits < CharT > , class Allocator = std:: allocator < CharT > > class basic_syncbuf : public std:: basic_streambuf < CharT, Traits >		(начиная с C++20)

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 , а не напрямую.

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

Определено в заголовке <syncstream>
Тип	Определение
std::syncbuf	std :: basic_syncbuf < char >
std::wsyncbuf	std :: basic_syncbuf < wchar_t >

Содержание 1 Типы членов 2 Функции-члены 3 Публичные функции-члены 4 Защищенные функции-члены 5 Нечленные функции 6 Наследуется от std:: basic_streambuf 6.1 Типы членов 6.2 Функции-члены 6.2.1 Локали 6.2.2 Позиционирование 6.2.3 Область получения 6.2.4 Область помещения 6.2.5 Возврат 6.3 Защищенные функции-члены 6.3.1 Локали 6.3.2 Позиционирование 6.3.3 Область получения 6.3.4 Область помещения 6.3.5 Возврат 6.4 Примечания

Типы членов

Тип члена	Определение
char_type	CharT
traits_type	Traits ; программа является некорректной, если Traits::char_type не является CharT .
int_type	Traits::int_type
pos_type	Traits::pos_type
off_type	Traits::off_type
allocator_type	Allocator
streambuf_type	std:: basic_streambuf < CharT, Traits >

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

Публичные функции-члены
(constructor)	создает объект basic_syncbuf (публичная функция-член)
operator=	присваивает объект basic_syncbuf (публичная функция-член)
swap	обменивает два объекта basic_syncbuf (публичная функция-член)
(destructor)	уничтожает basic_syncbuf и отправляет его внутренний буфер (публичная функция-член)
emit	атомарно передает весь внутренний буфер в обернутый streambuf (публичная функция-член)
get_wrapped	получает указатель на обернутый streambuf (публичная функция-член)
get_allocator	получает аллокатор, используемый этим basic_syncbuf (публичная функция-член)
set_emit_on_sync	изменяет текущую политику emit-on-sync (публичная функция-член)
Защищенные функции-члены
sync	либо отправляет, либо записывает отложенную очистку, в зависимости от текущей политики emit-on-sync (публичная функция-член)

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

std::swap (std::basic_syncbuf) (C++20)

специализирует алгоритм std::swap (шаблон функции)

Примечания

Макрос тестирования возможностей	Значение	Стандарт	Функция
__cpp_lib_syncbuf	201803L	(C++20)	Синхронизированный буферизованный ostream ( std::syncbuf , std::osyncstream ) и манипуляторы