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 对象指针作为键值）。

与其他流缓冲区类类似， std::basic_syncbuf 通常仅通过对应的流 std::osyncstream 进行访问，而非直接操作。

提供了几种常见字符类型的类型定义：

定义于头文件 <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 >

成员函数

公共成员函数
(构造函数)	构造 basic_syncbuf 对象 (公共成员函数)
operator=	赋值 basic_syncbuf 对象 (公共成员函数)
swap	交换两个 basic_syncbuf 对象 (公共成员函数)
(析构函数)	销毁 basic_syncbuf 并发送其内部缓冲区 (公共成员函数)
emit	原子地将整个内部缓冲区传输到包装的流缓冲区 (公共成员函数)
get_wrapped	获取包装的流缓冲区指针 (公共成员函数)
get_allocator	获取此 basic_syncbuf 使用的分配器 (公共成员函数)
set_emit_on_sync	更改当前同步时发送策略 (公共成员函数)
受保护成员函数
sync	根据当前同步时发送策略，发送缓冲区或记录待处理的刷新 (公共成员函数)

非成员函数

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

特化 std::swap 算法 (函数模板)

注释

功能测试 宏	值	标准	功能
__cpp_lib_syncbuf	201803L	(C++20)	同步缓冲输出流 ( std::syncbuf , std::osyncstream ) 及其操纵器