std::basic_syncbuf
来自 cppreference.com
定义在头文件 <syncstream> 中 |
||
template< class CharT, |
(自 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 访问,而不是直接访问。
为常见字符类型提供了一些类型定义
定义在头文件
<syncstream> 中 | |
类型 | 定义 |
std::syncbuf
|
std::basic_syncbuf<char> |
std::wsyncbuf
|
std::basic_syncbuf<wchar_t> |
内容 |
[编辑] 成员类型
成员类型 | 定义 |
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 对象(公共成员函数) | |
为 basic_syncbuf 对象赋值(公共成员函数) | |
交换两个 basic_syncbuf 对象(公共成员函数) | |
销毁 basic_syncbuf 并发出其内部缓冲区(公共成员函数) | |
原子地将整个内部缓冲区传输到包装的 streambuf (公共成员函数) | |
检索包装的 streambuf 指针 (公共成员函数) | |
检索此 basic_syncbuf 使用的分配器(公共成员函数) | |
更改当前的 emit-on-sync 策略 (公共成员函数) | |
受保护的成员函数 | |
根据当前的 emit-on-sync 策略,发出或记录一个挂起的刷新操作 (公共成员函数) |
[编辑] 非成员函数
专门化了 std::swap 算法 (函数模板) |
继承自 std::basic_streambuf
成员类型
成员类型 | 定义 |
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 |
成员函数
[虚拟] |
销毁 basic_streambuf 对象( std::basic_streambuf<CharT,Traits> 的虚拟公共成员函数) |
区域设置 | |
调用 imbue() ( std::basic_streambuf<CharT,Traits> 的公共成员函数) | |
获取关联区域设置的副本 ( std::basic_streambuf<CharT,Traits> 的公共成员函数) | |
定位 | |
调用 setbuf() ( std::basic_streambuf<CharT,Traits> 的公共成员函数) | |
调用 seekoff() ( std::basic_streambuf<CharT,Traits> 的公共成员函数) | |
调用 seekpos() ( std::basic_streambuf<CharT,Traits> 的公共成员函数) | |
调用 sync() ( std::basic_streambuf<CharT,Traits> 的公共成员函数) | |
获取区域 | |
获取获取区域中立即可用的字符数 ( std::basic_streambuf<CharT,Traits> 的公共成员函数) | |
前进输入序列,然后读取一个字符,但不再次前进 ( std::basic_streambuf<CharT,Traits> 的公共成员函数) | |
(在 C++17 中删除) |
从输入序列中读取一个字符并前进序列 ( std::basic_streambuf<CharT,Traits> 的公共成员函数) |
从输入序列中读取一个字符,但不前进序列 ( std::basic_streambuf<CharT,Traits> 的公共成员函数) | |
调用 xsgetn() ( std::basic_streambuf<CharT,Traits> 的公共成员函数) | |
放置区域 | |
将一个字符写入放置区域并前进下一个指针 ( std::basic_streambuf<CharT,Traits> 的公共成员函数) | |
调用 xsputn() ( std::basic_streambuf<CharT,Traits> 的公共成员函数) | |
回退 | |
将一个字符放回输入序列 ( std::basic_streambuf<CharT,Traits> 的公共成员函数) | |
将输入序列中的下一个指针向后移动一个位置 ( std::basic_streambuf<CharT,Traits> 的公共成员函数) |
受保护的成员函数
构造 basic_streambuf 对象(受保护的成员函数) | |
(C++11) |
替换 basic_streambuf 对象(受保护的成员函数) |
(C++11) |
交换两个 basic_streambuf 对象(受保护的成员函数) |
区域设置 | |
[虚拟] |
更改关联区域设置 ( std::basic_streambuf<CharT,Traits> 的虚拟受保护的成员函数) |
定位 | |
[虚拟] |
如果允许,用用户定义的数组替换缓冲区 ( std::basic_streambuf<CharT,Traits> 的虚拟受保护的成员函数) |
[虚拟] |
使用相对寻址重新定位输入序列、输出序列或两者的下一个指针 ( std::basic_streambuf<CharT,Traits> 的虚拟受保护的成员函数) |
[虚拟] |
使用绝对寻址重新定位输入序列、输出序列或两者的下一个指针 ( std::basic_streambuf<CharT,Traits> 的虚拟受保护的成员函数) |
[虚拟] |
将缓冲区与关联的字符序列同步 ( std::basic_streambuf<CharT,Traits> 的虚拟受保护的成员函数) |
获取区域 | |
[虚拟] |
获取关联的输入序列中可用于输入的字符数(如果已知) ( std::basic_streambuf<CharT,Traits> 的虚拟受保护的成员函数) |
[虚拟] |
从关联的输入序列读取字符到获取区域 ( std::basic_streambuf<CharT,Traits> 的虚拟受保护的成员函数) |
[虚拟] |
从关联的输入序列读取字符到获取区域并前进下一个指针 ( std::basic_streambuf<CharT,Traits> 的虚拟受保护的成员函数) |
[虚拟] |
从输入序列读取多个字符 ( std::basic_streambuf<CharT,Traits> 的虚拟受保护的成员函数) |
返回指向获取区域的开头、当前字符和结尾的指针 (受保护的成员函数) | |
前进输入序列中的下一个指针 (受保护的成员函数) | |
重新定位输入序列的开头、下一个和结尾指针 (受保护的成员函数) | |
放置区域 | |
[虚拟] |
将多个字符写入输出序列 ( std::basic_streambuf<CharT,Traits> 的虚拟受保护的成员函数) |
[虚拟] |
从放置区域将字符写入关联的输出序列 ( std::basic_streambuf<CharT,Traits> 的虚拟受保护的成员函数) |
返回指向放置区域的开头、当前字符和结尾的指针 (受保护的成员函数) | |
前进输出序列中的下一个指针 (受保护的成员函数) | |
重新定位输出序列的开头、下一个和结尾指针 (受保护的成员函数) | |
回退 | |
[虚拟] |
将一个字符放回输入序列,可能修改输入序列 ( std::basic_streambuf<CharT,Traits> 的虚拟受保护的成员函数) |
[编辑] 备注
功能测试 宏 | 值 | Std | 功能 |
---|---|---|---|
__cpp_lib_syncbuf |
201803L | (C++20) | 同步缓冲 ostream (std::syncbuf , std::osyncstream) 和操纵符 |